tegwick
484d919ffa
Implement comprehensive issue management system with pluggable backend support: ARCHITECTURE: - Abstract IssueBackend base class with standardized interface - Plugin discovery and configuration management system - Unified CLI integration with markitect issues commands BACKENDS IMPLEMENTED: - Gitea plugin: Integrates with existing GiteaIssueRepository infrastructure - Local plugin: File-based issue management with markdown + YAML frontmatter CLI COMMANDS: - markitect issues list [--state open|closed|all] [--backend name] - markitect issues show <id> [--backend name] - markitect issues create <title> <body> [--backend name] - markitect issues close <id> [--backend name] - markitect issues comment <id> <text> [--backend name] CONFIGURATION: - YAML-based backend configuration (.markitect/config/issues.yml) - Default backends: gitea (remote) and local (file-based) - Seamless backend switching via CLI options LOCAL FILE STRUCTURE: - .markitect/issues/open/ - Active issues as markdown files - .markitect/issues/closed/ - Completed issues - YAML frontmatter with issue metadata + markdown body - Git integration for version control of local issues TESTING: - Comprehensive test suite for plugin manager (15/17 tests passing) - Plugin interface validation and error handling - CLI integration tests (functional verification complete) This addresses the original problem where Claude sometimes missed existing issue functions and tried direct API calls. Now provides consistent, unified interface regardless of backend. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
102 lines
2.3 KiB
Python
102 lines
2.3 KiB
Python
"""
|
|
Abstract base class for issue management backends.
|
|
|
|
This module defines the interface that all issue management backends must implement.
|
|
"""
|
|
|
|
from abc import ABC, abstractmethod
|
|
from typing import List, Optional, Dict, Any
|
|
from domain.issues.models import Issue
|
|
|
|
|
|
class IssueBackend(ABC):
|
|
"""Abstract base class for issue management backends."""
|
|
|
|
def __init__(self, config: Dict[str, Any]):
|
|
"""Initialize backend with configuration."""
|
|
self.config = config
|
|
|
|
@abstractmethod
|
|
def list_issues(self, state: Optional[str] = None) -> List[Issue]:
|
|
"""
|
|
List issues with optional state filter.
|
|
|
|
Args:
|
|
state: Filter by state ('open', 'closed', 'all', or None for all)
|
|
|
|
Returns:
|
|
List of Issue objects
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def get_issue(self, issue_id: str) -> Issue:
|
|
"""
|
|
Get specific issue by ID.
|
|
|
|
Args:
|
|
issue_id: The issue identifier
|
|
|
|
Returns:
|
|
Issue object
|
|
|
|
Raises:
|
|
Exception: If issue not found
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def create_issue(self, title: str, body: str, **kwargs) -> Issue:
|
|
"""
|
|
Create new issue.
|
|
|
|
Args:
|
|
title: Issue title
|
|
body: Issue body/description
|
|
**kwargs: Additional issue properties (labels, assignees, etc.)
|
|
|
|
Returns:
|
|
Created Issue object
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def add_comment(self, issue_id: str, comment: str) -> Dict[str, Any]:
|
|
"""
|
|
Add comment to issue.
|
|
|
|
Args:
|
|
issue_id: The issue identifier
|
|
comment: Comment text
|
|
|
|
Returns:
|
|
Comment metadata (id, timestamp, etc.)
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def close_issue(self, issue_id: str) -> Issue:
|
|
"""
|
|
Close issue.
|
|
|
|
Args:
|
|
issue_id: The issue identifier
|
|
|
|
Returns:
|
|
Updated Issue object with closed state
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def update_issue(self, issue_id: str, **kwargs) -> Issue:
|
|
"""
|
|
Update issue properties.
|
|
|
|
Args:
|
|
issue_id: The issue identifier
|
|
**kwargs: Properties to update (title, body, state, etc.)
|
|
|
|
Returns:
|
|
Updated Issue object
|
|
"""
|
|
pass |