feat: Implement comprehensive project management system with issue lifecycle support

- Add ProjectManager with milestone and label-based project organization
- Support project states (Todo, Active, Review, Done, Blocked) via labels
- Add priority management (Low, Medium, High, Critical) with label integration
- Implement milestone creation and management for project tracking
- Enhance IssueWriter with project management methods (assign_to_milestone, add/remove_labels)
- Add 8 new CLI commands for complete project management workflow
- Support automatic project management setup with ensure_project_labels()
- Enable issue state transitions with automatic closing for completed issues
- Integrate with existing Gitea API authentication and error handling patterns

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-09-24 23:51:29 +02:00
parent 72f341279a
commit 2b681b31c6
4 changed files with 586 additions and 1 deletions

View File

@@ -15,6 +15,7 @@ from tddai import (
WorkspaceStatus, TddaiError
)
from tddai.issue_creator import IssueCreator
from tddai.project_manager import ProjectManager, ProjectState, Priority
def workspace_status():
@@ -460,6 +461,172 @@ def create_from_template(template_file: str, **kwargs):
sys.exit(1)
def setup_project_management():
"""Setup project management labels and milestones."""
try:
project_mgr = ProjectManager()
print("🚀 Setting up project management system...")
# Ensure all required labels exist
project_mgr.ensure_project_labels()
print("✅ Project management setup complete!")
print("📋 Available states: todo, active, review, done, blocked")
print("📊 Available priorities: low, medium, high, critical")
except TddaiError as e:
print(f"❌ Error setting up project management: {e}")
sys.exit(1)
def move_issue_to_state(issue_number: int, state: str):
"""Move issue to a specific project state."""
try:
project_mgr = ProjectManager()
# Convert string to ProjectState enum
state_map = {
'todo': ProjectState.TODO,
'active': ProjectState.ACTIVE,
'review': ProjectState.REVIEW,
'done': ProjectState.DONE,
'blocked': ProjectState.BLOCKED
}
if state not in state_map:
print(f"❌ Invalid state '{state}'. Valid states: {list(state_map.keys())}")
sys.exit(1)
project_state = state_map[state]
print(f"📋 Moving issue #{issue_number} to {state} state...")
result = project_mgr.set_issue_state(issue_number, project_state)
# If moving to done, also close the issue
if state == 'done':
project_mgr.move_issue_to_done(issue_number)
print(f"✅ Issue #{issue_number} moved to {state} and closed")
else:
print(f"✅ Issue #{issue_number} moved to {state}")
except TddaiError as e:
print(f"❌ Error moving issue to {state}: {e}")
sys.exit(1)
def set_issue_priority(issue_number: int, priority: str):
"""Set issue priority."""
try:
project_mgr = ProjectManager()
# Convert string to Priority enum
priority_map = {
'low': Priority.LOW,
'medium': Priority.MEDIUM,
'high': Priority.HIGH,
'critical': Priority.CRITICAL
}
if priority not in priority_map:
print(f"❌ Invalid priority '{priority}'. Valid priorities: {list(priority_map.keys())}")
sys.exit(1)
priority_level = priority_map[priority]
print(f"📊 Setting issue #{issue_number} priority to {priority}...")
result = project_mgr.set_issue_priority(issue_number, priority_level)
print(f"✅ Issue #{issue_number} priority set to {priority}")
except TddaiError as e:
print(f"❌ Error setting issue priority: {e}")
sys.exit(1)
def create_milestone(title: str, description: str = ""):
"""Create a new milestone (project)."""
try:
project_mgr = ProjectManager()
print(f"🚀 Creating milestone: {title}")
milestone = project_mgr.create_milestone(title, description)
print(f"✅ Milestone created successfully!")
print(f" ID: {milestone.id}")
print(f" Title: {milestone.title}")
print(f" Description: {milestone.description}")
print(f" State: {milestone.state}")
except TddaiError as e:
print(f"❌ Error creating milestone: {e}")
sys.exit(1)
def list_milestones():
"""List all milestones."""
try:
project_mgr = ProjectManager()
print("📋 Project Milestones")
print("====================")
print()
milestones = project_mgr.list_milestones("all")
if not milestones:
print("No milestones found")
return
for milestone in milestones:
status_icon = "🟢" if milestone.state == "open" else "🔴"
print(f"{status_icon} Milestone #{milestone.id}: {milestone.title}")
print(f" State: {milestone.state.upper()}")
print(f" Issues: {milestone.open_issues} open, {milestone.closed_issues} closed")
if milestone.description:
print(f" Description: {milestone.description}")
if milestone.due_on:
print(f" Due: {milestone.due_on}")
print()
except TddaiError as e:
print(f"❌ Error listing milestones: {e}")
sys.exit(1)
def assign_issue_to_milestone(issue_number: int, milestone_id: int):
"""Assign issue to a milestone."""
try:
from tddai.issue_writer import IssueWriter
writer = IssueWriter()
print(f"📋 Assigning issue #{issue_number} to milestone #{milestone_id}...")
result = writer.assign_to_milestone(issue_number, milestone_id)
print(f"✅ Issue #{issue_number} assigned to milestone #{milestone_id}")
except TddaiError as e:
print(f"❌ Error assigning issue to milestone: {e}")
sys.exit(1)
def project_overview():
"""Show project management overview."""
try:
project_mgr = ProjectManager()
print("📊 Project Management Overview")
print("==============================")
print()
overview = project_mgr.get_project_overview()
print(f"📋 Milestones: {overview['milestones']} total")
print(f" Active Projects: {overview['active_projects']}")
print(f" Completed Projects: {overview['completed_projects']}")
print(f"🏷️ Total Labels: {overview['total_labels']}")
print(f"🎯 Project Management Ready: {'✅ Yes' if overview['project_management_ready'] else '❌ No - run setup-project-mgmt'}")
except TddaiError as e:
print(f"❌ Error getting project overview: {e}")
sys.exit(1)
def main():
"""Main CLI entry point."""
parser = argparse.ArgumentParser(description="tddai CLI tool")
@@ -502,6 +669,28 @@ def main():
template_parser.add_argument('template_file', help='Template file path')
template_parser.add_argument('--vars', help='Template variables in key=value format', nargs='*', default=[])
# Project management commands
subparsers.add_parser('setup-project-mgmt', help='Setup project management labels and milestones')
subparsers.add_parser('project-overview', help='Show project management overview')
state_parser = subparsers.add_parser('set-issue-state', help='Set issue project state')
state_parser.add_argument('issue_number', type=int, help='Issue number')
state_parser.add_argument('state', choices=['todo', 'active', 'review', 'done', 'blocked'], help='Project state')
priority_parser = subparsers.add_parser('set-issue-priority', help='Set issue priority')
priority_parser.add_argument('issue_number', type=int, help='Issue number')
priority_parser.add_argument('priority', choices=['low', 'medium', 'high', 'critical'], help='Priority level')
milestone_parser = subparsers.add_parser('create-milestone', help='Create a new milestone (project)')
milestone_parser.add_argument('title', help='Milestone title')
milestone_parser.add_argument('--description', help='Milestone description', default='')
subparsers.add_parser('list-milestones', help='List all milestones')
assign_parser = subparsers.add_parser('assign-to-milestone', help='Assign issue to milestone')
assign_parser.add_argument('issue_number', type=int, help='Issue number')
assign_parser.add_argument('milestone_id', type=int, help='Milestone ID')
args = parser.parse_args()
if not args.command:
@@ -540,6 +729,20 @@ def main():
key, value = var.split('=', 1)
template_vars[key] = value
create_from_template(args.template_file, **template_vars)
elif args.command == 'setup-project-mgmt':
setup_project_management()
elif args.command == 'project-overview':
project_overview()
elif args.command == 'set-issue-state':
move_issue_to_state(args.issue_number, args.state)
elif args.command == 'set-issue-priority':
set_issue_priority(args.issue_number, args.priority)
elif args.command == 'create-milestone':
create_milestone(args.title, args.description)
elif args.command == 'list-milestones':
list_milestones()
elif args.command == 'assign-to-milestone':
assign_issue_to_milestone(args.issue_number, args.milestone_id)
except KeyboardInterrupt:
print("\n⚠️ Operation cancelled")
sys.exit(1)