claude-mpm 3.3.0__py3-none-any.whl → 3.4.0__py3-none-any.whl

claude_mpm/schemas/ticket_workflow_schema.json

@@ -1,590 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "version": "1.0.0",
-  "title": "Claude MPM Ticket Workflow Schema",
-  "description": "Schema definition for ticket workflow management in Claude MPM. This schema enforces the structure and validation rules for ticket status workflows, resolution types, and state transitions.",
-  "type": "object",
-  "required": [
-    "schema_version",
-    "workflow_id",
-    "workflow_version",
-    "metadata",
-    "status_states",
-    "resolution_types",
-    "transitions",
-    "status_resolution_mapping"
-  ],
-  "properties": {
-    "schema_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Schema version for the ticket workflow format. This ensures compatibility between the workflow definition and the schema validator.",
-      "examples": ["1.0.0", "1.1.0"]
-    },
-    "workflow_id": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9_]*$",
-      "description": "Unique workflow identifier used for workflow discovery and loading. This ID must be unique across all workflows in the system.",
-      "examples": ["standard_workflow", "support_workflow", "bug_tracking_workflow"]
-    },
-    "workflow_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Semantic version of the workflow definition itself (not the schema). Increment major for breaking changes, minor for new features, patch for bug fixes.",
-      "examples": ["1.0.0", "2.1.3"]
-    },
-    "metadata": {
-      "type": "object",
-      "required": [
-        "name",
-        "description",
-        "workflow_type"
-      ],
-      "properties": {
-        "name": {
-          "type": "string",
-          "minLength": 3,
-          "maxLength": 50,
-          "description": "Human-readable workflow name displayed in UI and logs."
-        },
-        "description": {
-          "type": "string",
-          "minLength": 10,
-          "maxLength": 200,
-          "description": "Brief description of workflow purpose and use cases."
-        },
-        "workflow_type": {
-          "type": "string",
-          "enum": ["standard", "support", "bug_tracking", "feature_request", "task_management", "custom"],
-          "description": "Type of workflow that determines its primary use case and default behaviors."
-        },
-        "author": {
-          "type": "string",
-          "description": "Workflow author or maintainer"
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date-time",
-          "description": "Creation timestamp"
-        },
-        "updated_at": {
-          "type": "string",
-          "format": "date-time",
-          "description": "Last update timestamp"
-        },
-        "tags": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9-]*$"
-          },
-          "uniqueItems": true,
-          "description": "Tags for workflow categorization and discovery"
-        }
-      }
-    },
-    "status_states": {
-      "type": "object",
-      "description": "Definition of all possible status states in the workflow. Status tracks the current position in the workflow lifecycle.",
-      "required": ["states"],
-      "properties": {
-        "states": {
-          "type": "array",
-          "minItems": 3,
-          "items": {
-            "type": "object",
-            "required": ["id", "name", "description", "category"],
-            "properties": {
-              "id": {
-                "type": "string",
-                "pattern": "^[a-z][a-z0-9_]*$",
-                "description": "Unique identifier for the status state"
-              },
-              "name": {
-                "type": "string",
-                "description": "Display name for the status"
-              },
-              "description": {
-                "type": "string",
-                "description": "Detailed description of what this status means"
-              },
-              "category": {
-                "type": "string",
-                "enum": ["initial", "active", "waiting", "terminal"],
-                "description": "Category of the status for grouping and logic"
-              },
-              "is_default": {
-                "type": "boolean",
-                "default": false,
-                "description": "Whether this is the default status for new tickets"
-              },
-              "color": {
-                "type": "string",
-                "pattern": "^#[0-9A-Fa-f]{6}$",
-                "description": "Hex color code for UI display"
-              },
-              "icon": {
-                "type": "string",
-                "description": "Icon identifier for UI display"
-              },
-              "sla_hours": {
-                "type": "integer",
-                "minimum": 0,
-                "description": "SLA hours for this status (optional)"
-              }
-            }
-          }
-        },
-        "default_status": {
-          "type": "string",
-          "description": "ID of the default status for new tickets"
-        }
-      }
-    },
-    "resolution_types": {
-      "type": "object",
-      "description": "Definition of all possible resolution types. Resolution tracks the outcome reasoning of a ticket.",
-      "required": ["types"],
-      "properties": {
-        "types": {
-          "type": "array",
-          "minItems": 1,
-          "items": {
-            "type": "object",
-            "required": ["id", "name", "description", "category"],
-            "properties": {
-              "id": {
-                "type": "string",
-                "pattern": "^[a-z][a-z0-9_]*$",
-                "description": "Unique identifier for the resolution type"
-              },
-              "name": {
-                "type": "string",
-                "description": "Display name for the resolution"
-              },
-              "description": {
-                "type": "string",
-                "description": "Detailed description of what this resolution means"
-              },
-              "category": {
-                "type": "string",
-                "enum": ["successful", "unsuccessful", "invalid", "deferred"],
-                "description": "Category of the resolution for reporting and metrics"
-              },
-              "requires_comment": {
-                "type": "boolean",
-                "default": false,
-                "description": "Whether a comment is required when using this resolution"
-              },
-              "color": {
-                "type": "string",
-                "pattern": "^#[0-9A-Fa-f]{6}$",
-                "description": "Hex color code for UI display"
-              },
-              "icon": {
-                "type": "string",
-                "description": "Icon identifier for UI display"
-              }
-            }
-          }
-        }
-      }
-    },
-    "transitions": {
-      "type": "object",
-      "description": "Definition of valid state transitions in the workflow",
-      "required": ["rules"],
-      "properties": {
-        "rules": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["from_status", "to_status", "name"],
-            "properties": {
-              "from_status": {
-                "type": "string",
-                "description": "Source status ID (use '*' for any status)"
-              },
-              "to_status": {
-                "type": "string",
-                "description": "Target status ID"
-              },
-              "name": {
-                "type": "string",
-                "description": "Name of the transition action"
-              },
-              "description": {
-                "type": "string",
-                "description": "Description of the transition"
-              },
-              "required_fields": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Fields that must be set for this transition"
-              },
-              "permissions": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "Required permissions for this transition"
-              },
-              "auto_assign": {
-                "type": "boolean",
-                "default": false,
-                "description": "Whether to auto-assign the ticket during this transition"
-              },
-              "triggers": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "type": {
-                      "type": "string",
-                      "enum": ["webhook", "notification", "automation"]
-                    },
-                    "config": {
-                      "type": "object"
-                    }
-                  }
-                },
-                "description": "Actions triggered by this transition"
-              }
-            }
-          }
-        },
-        "allow_self_transitions": {
-          "type": "boolean",
-          "default": false,
-          "description": "Whether tickets can transition to the same status"
-        }
-      }
-    },
-    "status_resolution_mapping": {
-      "type": "object",
-      "description": "Mapping of which resolutions are valid for which statuses",
-      "required": ["mappings"],
-      "properties": {
-        "mappings": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["status_id", "allowed_resolutions"],
-            "properties": {
-              "status_id": {
-                "type": "string",
-                "description": "Status ID"
-              },
-              "allowed_resolutions": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                },
-                "description": "List of resolution IDs allowed for this status"
-              },
-              "requires_resolution": {
-                "type": "boolean",
-                "default": false,
-                "description": "Whether a resolution is required for this status"
-              },
-              "default_resolution": {
-                "type": "string",
-                "description": "Default resolution ID for this status"
-              }
-            }
-          }
-        }
-      }
-    },
-    "business_rules": {
-      "type": "object",
-      "description": "Business rules and constraints for the workflow",
-      "properties": {
-        "auto_close": {
-          "type": "object",
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": false
-            },
-            "days_after_resolved": {
-              "type": "integer",
-              "minimum": 1,
-              "description": "Days after resolution before auto-closing"
-            },
-            "excluded_resolutions": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Resolution IDs that prevent auto-close"
-            }
-          }
-        },
-        "reopen_rules": {
-          "type": "object",
-          "properties": {
-            "allow_reopen": {
-              "type": "boolean",
-              "default": true
-            },
-            "from_statuses": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Status IDs from which tickets can be reopened"
-            },
-            "max_reopen_count": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Maximum number of times a ticket can be reopened"
-            },
-            "reopen_window_days": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Days after closing during which reopening is allowed"
-            }
-          }
-        },
-        "escalation_rules": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["condition", "action"],
-            "properties": {
-              "name": {
-                "type": "string"
-              },
-              "condition": {
-                "type": "object",
-                "properties": {
-                  "status": {
-                    "type": "string"
-                  },
-                  "hours_in_status": {
-                    "type": "integer"
-                  },
-                  "priority": {
-                    "type": "string"
-                  }
-                }
-              },
-              "action": {
-                "type": "object",
-                "properties": {
-                  "change_status": {
-                    "type": "string"
-                  },
-                  "change_priority": {
-                    "type": "string"
-                  },
-                  "notify": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "ui_configuration": {
-      "type": "object",
-      "description": "UI-specific configuration for the workflow",
-      "properties": {
-        "status_display_order": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Order in which statuses should be displayed"
-        },
-        "resolution_display_order": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Order in which resolutions should be displayed"
-        },
-        "quick_transitions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "from_status": {
-                "type": "string"
-              },
-              "to_status": {
-                "type": "string"
-              },
-              "button_label": {
-                "type": "string"
-              },
-              "button_style": {
-                "type": "string",
-                "enum": ["primary", "secondary", "success", "danger", "warning"]
-              }
-            }
-          },
-          "description": "Quick action buttons for common transitions"
-        }
-      }
-    },
-    "metrics": {
-      "type": "object",
-      "description": "Metrics and reporting configuration",
-      "properties": {
-        "cycle_time_statuses": {
-          "type": "object",
-          "properties": {
-            "start": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Status IDs that mark the start of cycle time"
-            },
-            "end": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Status IDs that mark the end of cycle time"
-            }
-          }
-        },
-        "resolution_metrics": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "name": {
-                "type": "string"
-              },
-              "resolution_ids": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "metric_type": {
-                "type": "string",
-                "enum": ["success_rate", "failure_rate", "defect_rate", "satisfaction_rate"]
-              }
-            }
-          }
-        }
-      }
-    }
-  },
-  "additionalProperties": false,
-  "definitions": {
-    "standard_statuses": {
-      "description": "Common status states used across different workflow types",
-      "open": {
-        "name": "Open/New",
-        "description": "Ticket has been created but not yet assigned or started",
-        "category": "initial"
-      },
-      "in_progress": {
-        "name": "In Progress/Assigned",
-        "description": "Ticket is actively being worked on",
-        "category": "active"
-      },
-      "pending": {
-        "name": "Pending/Waiting",
-        "description": "Ticket is waiting for external input or dependencies",
-        "category": "waiting"
-      },
-      "resolved": {
-        "name": "Resolved",
-        "description": "Work is complete and solution has been implemented",
-        "category": "terminal"
-      },
-      "closed": {
-        "name": "Closed",
-        "description": "Ticket is closed and no further action is required",
-        "category": "terminal"
-      },
-      "reopened": {
-        "name": "Reopened",
-        "description": "Previously closed ticket has been reopened",
-        "category": "active"
-      },
-      "on_hold": {
-        "name": "On Hold",
-        "description": "Work is temporarily suspended",
-        "category": "waiting"
-      },
-      "escalated": {
-        "name": "Escalated",
-        "description": "Ticket has been escalated to higher priority or management",
-        "category": "active"
-      },
-      "canceled": {
-        "name": "Canceled",
-        "description": "Ticket has been canceled before completion",
-        "category": "terminal"
-      }
-    },
-    "standard_resolutions": {
-      "description": "Common resolution types used across different workflow types",
-      "fixed": {
-        "name": "Fixed/Resolved",
-        "description": "Issue was successfully fixed or request was fulfilled",
-        "category": "successful"
-      },
-      "wont_fix": {
-        "name": "Won't Fix",
-        "description": "Decision made not to address the issue",
-        "category": "unsuccessful"
-      },
-      "duplicate": {
-        "name": "Duplicate",
-        "description": "Issue is a duplicate of another ticket",
-        "category": "invalid"
-      },
-      "cannot_reproduce": {
-        "name": "Cannot Reproduce",
-        "description": "Issue cannot be reproduced or verified",
-        "category": "invalid"
-      },
-      "works_as_designed": {
-        "name": "Works as Designed",
-        "description": "Behavior is intentional and not a bug",
-        "category": "invalid"
-      },
-      "incomplete": {
-        "name": "Incomplete",
-        "description": "Insufficient information to proceed",
-        "category": "unsuccessful"
-      },
-      "user_error": {
-        "name": "User Error",
-        "description": "Issue was due to user error or misunderstanding",
-        "category": "invalid"
-      },
-      "configuration": {
-        "name": "Configuration",
-        "description": "Issue was resolved through configuration changes",
-        "category": "successful"
-      },
-      "workaround": {
-        "name": "Workaround",
-        "description": "A workaround has been provided",
-        "category": "successful"
-      },
-      "documentation": {
-        "name": "Documentation",
-        "description": "Issue was resolved by updating or providing documentation",
-        "category": "successful"
-      }
-    }
-  }
-}

claude_mpm/services/framework_claude_md_generator/README.md

@@ -1,92 +0,0 @@
-# Framework CLAUDE.md Generator
-
-This directory contains the refactored framework CLAUDE.md generator service, originally a single 1,267-line file.
-
-## Structure
-
-### Core Modules
-
-- **`__init__.py`** (~250 lines) - Main facade class that coordinates all functionality
-- **`version_manager.py`** (~100 lines) - Handles version parsing, incrementing, and comparison
-- **`content_assembler.py`** (~120 lines) - Assembles sections and applies template variables
-- **`content_validator.py`** (~80 lines) - Validates generated content structure and completeness
-- **`deployment_manager.py`** (~80 lines) - Handles deployment to parent directories
-- **`section_manager.py`** (~60 lines) - Manages section registration, ordering, and updates
-
-### Section Generators
-
-The `section_generators/` subdirectory contains individual generators for each section:
-
-- **`__init__.py`** - Base classes and registry
-- **`header.py`** - Header with version metadata
-- **`role_designation.py`** - AI Assistant role designation
-- **`agents.py`** (~570 lines) - Comprehensive agents documentation (largest section)
-- **`todo_task_tools.py`** - Todo and Task Tools integration
-- **`claude_pm_init.py`** - Claude-PM initialization procedures
-- **`orchestration_principles.py`** - Core orchestration principles
-- **`subprocess_validation.py`** - Subprocess validation protocol
-- **`delegation_constraints.py`** - Critical delegation constraints
-- **`environment_config.py`** - Environment configuration
-- **`troubleshooting.py`** - Troubleshooting guide
-- **`core_responsibilities.py`** - Core responsibilities list
-- **`footer.py`** - Footer with metadata
-
-## Usage
-
-The API remains unchanged from the original implementation:
-
-```python
-from claude_pm.services.framework_claude_md_generator import FrameworkClaudeMdGenerator
-
-# Create generator instance
-generator = FrameworkClaudeMdGenerator()
-
-# Generate content
-content = generator.generate(
-    current_content=existing_content,  # Optional: for version auto-increment
-    template_variables={'PLATFORM': 'darwin', 'PYTHON_CMD': 'python3'}
-)
-
-# Deploy to parent directory
-success, message = generator.deploy_to_parent(Path('/parent/dir'))
-
-# Update a section
-generator.update_section('agents', 'Custom agents content')
-
-# Add custom section
-generator.add_custom_section('custom', 'Custom content', after='agents')
-```
-
-## Design Benefits
-
-1. **Modularity**: Each concern is separated into its own module
-2. **Maintainability**: Smaller, focused modules are easier to understand and modify
-3. **Testability**: Individual components can be tested in isolation
-4. **Extensibility**: New section generators can be added easily
-5. **Performance**: Section generators are loaded on demand
-6. **Backward Compatibility**: Original API preserved through facade pattern
-
-## Section Generator Pattern
-
-To add a new section generator:
-
-1. Create a new file in `section_generators/`
-2. Inherit from `BaseSectionGenerator`
-3. Implement the `generate()` method
-4. Register in `section_generators/__init__.py`
-
-Example:
-```python
-from . import BaseSectionGenerator
-
-class CustomSectionGenerator(BaseSectionGenerator):
-    def generate(self, data: Dict[str, Any]) -> str:
-        return "## Custom Section\n\nContent here..."
-```
-
-## Refactoring Summary
-
-- **Original**: 1,267 lines in a single file
-- **Refactored**: ~250 lines in main module + well-organized submodules
-- **Total line reduction**: Main module reduced by 80%
-- **Improved organization**: 13 focused modules instead of 1 large file