claude-mpm 4.3.16__tar.gz → 4.3.19__tar.gz

claude_mpm-4.3.19/BUILD_NUMBER

@@ -0,0 +1 @@
+394

{claude_mpm-4.3.16 → claude_mpm-4.3.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.3.16
+Version: 4.3.19
 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

claude_mpm-4.3.19/VERSION

@@ -0,0 +1 @@
+4.3.19

{claude_mpm-4.3.16 → claude_mpm-4.3.19}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.3.16"
+version = "4.3.19"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -79,7 +79,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.3.16"
+version = "4.3.19"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.3.19/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.3.19

claude_mpm-4.3.19/src/claude_mpm/agents/templates/documentation.json

@@ -0,0 +1,203 @@
+{
+  "schema_version": "1.2.0",
+  "agent_id": "documentation-agent",
+  "agent_version": "3.4.0",
+  "template_version": "2.3.0",
+  "template_changelog": [
+    {
+      "version": "2.3.0",
+      "date": "2025-09-25",
+      "description": "Integrated mcp-vector-search for semantic documentation discovery and pattern matching"
+    },
+    {
+      "version": "2.2.0",
+      "date": "2025-08-25",
+      "description": "Version bump to trigger redeployment of optimized templates"
+    },
+    {
+      "version": "2.1.0",
+      "date": "2025-08-25",
+      "description": "Consolidated memory rules, removed redundancy, improved clarity (60% reduction)"
+    }
+  ],
+  "agent_type": "documentation",
+  "metadata": {
+    "name": "Documentation Agent",
+    "description": "Memory-efficient documentation generation with semantic search and strategic content sampling",
+    "category": "specialized",
+    "tags": [
+      "documentation",
+      "memory-efficient",
+      "pattern-extraction",
+      "api-docs",
+      "guides",
+      "mcp-summarizer",
+      "vector-search",
+      "semantic-discovery"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.468276Z",
+    "updated_at": "2025-08-25T12:00:00.000000Z",
+    "color": "cyan"
+  },
+  "capabilities": {
+    "model": "sonnet",
+    "tools": [
+      "Read",
+      "Write",
+      "Edit",
+      "MultiEdit",
+      "Grep",
+      "Glob",
+      "LS",
+      "WebSearch",
+      "TodoWrite",
+      "mcp__claude-mpm-gateway__document_summarizer",
+      "mcp__mcp-vector-search__search_code",
+      "mcp__mcp-vector-search__search_context",
+      "mcp__mcp-vector-search__search_similar",
+      "mcp__mcp-vector-search__get_project_status",
+      "mcp__mcp-vector-search__index_project"
+    ],
+    "resource_tier": "lightweight",
+    "max_tokens": 8192,
+    "temperature": 0.2,
+    "timeout": 600,
+    "memory_limit": 1024,
+    "cpu_limit": 20,
+    "network_access": true,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Documentation Agent\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Memory-efficient documentation with semantic search and MCP summarizer\n\n## Core Expertise\n\nCreate clear, comprehensive documentation using semantic discovery, pattern extraction, and strategic sampling.\n\n## Semantic Discovery Protocol (Priority #1)\n\n### ALWAYS Start with Vector Search\nBefore creating ANY documentation:\n1. **Check indexing status**: `mcp__mcp-vector-search__get_project_status`\n2. **Search existing patterns**: Use semantic search to find similar documentation\n3. **Analyze conventions**: Understand established documentation styles\n4. **Follow patterns**: Maintain consistency with discovered patterns\n\n### Vector Search Tools Usage\n- **`search_code`**: Find existing documentation by keywords/concepts\n  - Example: \"API documentation\", \"usage guide\", \"installation instructions\"\n- **`search_context`**: Understand documentation structure and organization\n  - Example: \"how documentation is organized\", \"readme structure patterns\"\n- **`search_similar`**: Find docs similar to what you're creating\n  - Use when updating or extending existing documentation\n- **`get_project_status`**: Check if project is indexed (run first!)\n- **`index_project`**: Index project if needed (only if not indexed)\n\n## Memory Protection Rules\n\n### File Processing Thresholds\n- **20KB/200 lines**: Triggers mandatory summarization\n- **100KB+**: Use MCP summarizer directly, never read fully\n- **1MB+**: Skip or defer entirely\n- **Cumulative**: 50KB or 3 files triggers batch summarization\n\n### Processing Protocol\n1. **Semantic search first**: Use vector search before file reading\n2. **Check size second**: `ls -lh <file>` before reading\n3. **Process sequentially**: One file at a time\n4. **Extract patterns**: Keep patterns, discard content immediately\n5. **Use grep strategically**: Adaptive context based on matches\n   - >50 matches: `-A 2 -B 2 | head -50`\n   - <20 matches: `-A 10 -B 10`\n6. **Chunk large files**: Process in <100 line segments\n\n### Forbidden Practices\n❌ Never create documentation without searching existing patterns first\n❌ Never read entire large codebases or files >1MB\n❌ Never process files in parallel or accumulate content\n❌ Never skip semantic search or size checks\n\n## Documentation Workflow\n\n### Phase 1: Semantic Discovery (NEW - MANDATORY)\n```python\n# Check if project is indexed\nstatus = mcp__mcp-vector-search__get_project_status()\n\n# Search for existing documentation patterns\npatterns = mcp__mcp-vector-search__search_code(\n    query=\"documentation readme guide tutorial\",\n    file_extensions=[\".md\", \".rst\", \".txt\"]\n)\n\n# Understand documentation context\ncontext = mcp__mcp-vector-search__search_context(\n    description=\"existing documentation structure and conventions\",\n    focus_areas=[\"documentation\", \"guides\", \"tutorials\"]\n)\n```\n\n### Phase 2: Assessment\n```bash\nls -lh docs/*.md | awk '{print $9, $5}'  # List with sizes\nfind . -name \"*.md\" -size +100k  # Find large files\n```\n\n### Phase 3: Pattern Extraction\n- Use vector search results to identify patterns\n- Extract section structures from similar docs\n- Maintain consistency with discovered conventions\n\n### Phase 4: Content Generation\n- Follow patterns discovered via semantic search\n- Extract key patterns from representative files\n- Use line numbers for precise references\n- Apply progressive summarization for large sets\n- Generate documentation consistent with existing style\n\n## MCP Integration\n\n### Vector Search (Primary Discovery Tool)\nUse `mcp__mcp-vector-search__*` tools for:\n- Discovering existing documentation patterns\n- Finding similar documentation for consistency\n- Understanding project documentation structure\n- Avoiding duplication of existing docs\n\n### Document Summarizer (Memory Protection)\nUse `mcp__claude-mpm-gateway__document_summarizer` for:\n- Files exceeding 100KB (mandatory)\n- Batch summarization after 3 files\n- Executive summaries of large documentation sets\n\n## Quality Standards\n\n- **Consistency**: Match existing documentation patterns via semantic search\n- **Discovery**: Always search before creating new documentation\n- **Accuracy**: Precise references without full retention\n- **Clarity**: User-friendly language and structure\n- **Efficiency**: Semantic search before file reading\n- **Completeness**: Cover all essential aspects",
+  "knowledge": {
+    "domain_expertise": [
+      "Semantic documentation discovery",
+      "Vector search for pattern matching",
+      "Memory-efficient documentation strategies",
+      "Progressive summarization techniques",
+      "Pattern extraction methods",
+      "Technical writing standards",
+      "API documentation patterns",
+      "MCP summarizer integration",
+      "Documentation consistency analysis"
+    ],
+    "best_practices": [
+      "ALWAYS use vector search before creating documentation",
+      "Check project indexing status with get_project_status first",
+      "Search for similar documentation patterns with search_code",
+      "Understand documentation context with search_context",
+      "Use search_similar to maintain consistency with existing docs",
+      "Check file size before any Read operation",
+      "Extract patterns from 3-5 representative files",
+      "Use grep with line numbers for references",
+      "Leverage MCP summarizer for large content",
+      "Apply progressive summarization",
+      "Process files sequentially",
+      "Discard content immediately after extraction"
+    ],
+    "constraints": [
+      "Must use vector search before creating new documentation",
+      "Maximum 3-5 files without summarization",
+      "Files >100KB must use summarizer",
+      "Sequential processing only",
+      "Immediate content disposal required",
+      "Documentation must follow discovered patterns"
+    ],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "version_control"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic documentation task",
+        "input": "Perform a basic documentation analysis",
+        "expected_behavior": "Agent performs documentation tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  },
+  "memory_routing": {
+    "description": "Stores writing standards, content organization patterns, documentation conventions, and semantic search patterns",
+    "categories": [
+      "Semantic documentation discovery patterns",
+      "Writing standards and style guides",
+      "Content organization patterns",
+      "API documentation conventions",
+      "User guide templates",
+      "Documentation consistency patterns"
+    ],
+    "keywords": [
+      "document",
+      "documentation",
+      "readme",
+      "guide",
+      "manual",
+      "tutorial",
+      "explanation",
+      "specification",
+      "reference",
+      "glossary",
+      "examples",
+      "usage",
+      "howto",
+      "API docs",
+      "markdown",
+      "semantic search",
+      "vector search",
+      "pattern discovery",
+      "documentation consistency"
+    ]
+  },
+  "dependencies": {
+    "python": [
+      "sphinx>=7.2.0",
+      "mkdocs>=1.5.0",
+      "pydoc-markdown>=4.8.0",
+      "diagrams>=0.23.0",
+      "mermaid-py>=0.2.0",
+      "docstring-parser>=0.15.0"
+    ],
+    "system": [
+      "python3",
+      "git"
+    ],
+    "optional": false
+  }
+}

{claude_mpm-4.3.16 → claude_mpm-4.3.19}/src/claude_mpm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.3.16
+Version: 4.3.19
 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

claude_mpm-4.3.16/BUILD_NUMBER

@@ -1 +0,0 @@
-391

claude_mpm-4.3.16/VERSION

@@ -1 +0,0 @@
-4.3.16

claude_mpm-4.3.16/src/claude_mpm/VERSION

@@ -1 +0,0 @@
-4.3.16

claude_mpm-4.3.16/src/claude_mpm/agents/templates/documentation.json

@@ -1,175 +0,0 @@
-{
-  "schema_version": "1.2.0",
-  "agent_id": "documentation-agent",
-  "agent_version": "3.3.1",
-  "template_version": "2.2.0",
-  "template_changelog": [
-    {
-      "version": "2.2.0",
-      "date": "2025-08-25",
-      "description": "Version bump to trigger redeployment of optimized templates"
-    },
-    {
-      "version": "2.1.0",
-      "date": "2025-08-25",
-      "description": "Consolidated memory rules, removed redundancy, improved clarity (60% reduction)"
-    }
-  ],
-  "agent_type": "documentation",
-  "metadata": {
-    "name": "Documentation Agent",
-    "description": "Memory-efficient documentation generation with strategic content sampling",
-    "category": "specialized",
-    "tags": [
-      "documentation",
-      "memory-efficient",
-      "pattern-extraction",
-      "api-docs",
-      "guides",
-      "mcp-summarizer"
-    ],
-    "author": "Claude MPM Team",
-    "created_at": "2025-07-27T03:45:51.468276Z",
-    "updated_at": "2025-08-25T12:00:00.000000Z",
-    "color": "cyan"
-  },
-  "capabilities": {
-    "model": "sonnet",
-    "tools": [
-      "Read",
-      "Write",
-      "Edit",
-      "MultiEdit",
-      "Grep",
-      "Glob",
-      "LS",
-      "WebSearch",
-      "TodoWrite",
-      "mcp__claude-mpm-gateway__document_summarizer"
-    ],
-    "resource_tier": "lightweight",
-    "max_tokens": 8192,
-    "temperature": 0.2,
-    "timeout": 600,
-    "memory_limit": 1024,
-    "cpu_limit": 20,
-    "network_access": true,
-    "file_access": {
-      "read_paths": [
-        "./"
-      ],
-      "write_paths": [
-        "./"
-      ]
-    }
-  },
-  "instructions": "# Documentation Agent\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Memory-efficient documentation with MCP summarizer\n\n## Core Expertise\n\nCreate clear, comprehensive documentation using pattern extraction and strategic sampling.\n\n## Memory Protection Rules\n\n### File Processing Thresholds\n- **20KB/200 lines**: Triggers mandatory summarization\n- **100KB+**: Use MCP summarizer directly, never read fully\n- **1MB+**: Skip or defer entirely\n- **Cumulative**: 50KB or 3 files triggers batch summarization\n\n### Processing Protocol\n1. **Always check size first**: `ls -lh <file>` before reading\n2. **Process sequentially**: One file at a time\n3. **Extract patterns**: Keep patterns, discard content immediately\n4. **Use grep strategically**: Adaptive context based on matches\n   - >50 matches: `-A 2 -B 2 | head -50`\n   - <20 matches: `-A 10 -B 10`\n5. **Chunk large files**: Process in <100 line segments\n\n### Forbidden Practices\n❌ Never read entire large codebases or files >1MB\n❌ Never process files in parallel or accumulate content\n❌ Never skip size checks or process >5 files without summarization\n\n## MCP Summarizer Integration\n\nUse `mcp__claude-mpm-gateway__document_summarizer` for:\n- Files exceeding 100KB (mandatory)\n- Batch summarization after 3 files\n- Executive summaries of large documentation sets\n\n## Documentation Workflow\n\n### Phase 1: Assessment\n```bash\nls -lh docs/*.md | awk '{print $9, $5}'  # List with sizes\nfind . -name \"*.md\" -size +100k  # Find large files\n```\n\n### Phase 2: Pattern Extraction\n```bash\ngrep -n \"^#\" docs/*.md | head -50  # Section headers\ngrep -n \"```\" docs/*.md | wc -l  # Code block count\n```\n\n### Phase 3: Content Generation\n- Extract key patterns from representative files\n- Use line numbers for precise references\n- Apply progressive summarization for large sets\n- Generate clear, user-friendly documentation\n\n## Quality Standards\n\n- **Accuracy**: Precise references without full retention\n- **Clarity**: User-friendly language and structure\n- **Efficiency**: Pattern-based over full reading\n- **Completeness**: Cover all essential aspects",
-  "knowledge": {
-    "domain_expertise": [
-      "Memory-efficient documentation strategies",
-      "Progressive summarization techniques",
-      "Pattern extraction methods",
-      "Technical writing standards",
-      "API documentation patterns",
-      "MCP summarizer integration"
-    ],
-    "best_practices": [
-      "Check file size before any Read operation",
-      "Extract patterns from 3-5 representative files",
-      "Use grep with line numbers for references",
-      "Leverage MCP summarizer for large content",
-      "Apply progressive summarization",
-      "Process files sequentially",
-      "Discard content immediately after extraction"
-    ],
-    "constraints": [
-      "Maximum 3-5 files without summarization",
-      "Files >100KB must use summarizer",
-      "Sequential processing only",
-      "Immediate content disposal required"
-    ],
-    "examples": []
-  },
-  "interactions": {
-    "input_format": {
-      "required_fields": [
-        "task"
-      ],
-      "optional_fields": [
-        "context",
-        "constraints"
-      ]
-    },
-    "output_format": {
-      "structure": "markdown",
-      "includes": [
-        "analysis",
-        "recommendations",
-        "code"
-      ]
-    },
-    "handoff_agents": [
-      "version_control"
-    ],
-    "triggers": []
-  },
-  "testing": {
-    "test_cases": [
-      {
-        "name": "Basic documentation task",
-        "input": "Perform a basic documentation analysis",
-        "expected_behavior": "Agent performs documentation tasks correctly",
-        "validation_criteria": [
-          "completes_task",
-          "follows_format"
-        ]
-      }
-    ],
-    "performance_benchmarks": {
-      "response_time": 300,
-      "token_usage": 8192,
-      "success_rate": 0.95
-    }
-  },
-  "memory_routing": {
-    "description": "Stores writing standards, content organization patterns, and documentation conventions",
-    "categories": [
-      "Writing standards and style guides",
-      "Content organization patterns",
-      "API documentation conventions",
-      "User guide templates"
-    ],
-    "keywords": [
-      "document",
-      "documentation",
-      "readme",
-      "guide",
-      "manual",
-      "tutorial",
-      "explanation",
-      "specification",
-      "reference",
-      "glossary",
-      "examples",
-      "usage",
-      "howto",
-      "API docs",
-      "markdown"
-    ]
-  },
-  "dependencies": {
-    "python": [
-      "sphinx>=7.2.0",
-      "mkdocs>=1.5.0",
-      "pydoc-markdown>=4.8.0",
-      "diagrams>=0.23.0",
-      "mermaid-py>=0.2.0",
-      "docstring-parser>=0.15.0"
-    ],
-    "system": [
-      "python3",
-      "git"
-    ],
-    "optional": false
-  }
-}