refactor: remove obsolete issue management system in favor of issue-facade
Some checks failed
Test Suite / security-scan (push) Has been cancelled
Test Suite / test-summary (push) Has been cancelled
Test Suite / unit-tests (3.11) (push) Has been cancelled
Test Suite / unit-tests (3.12) (push) Has been cancelled
Test Suite / integration-tests (push) Has been cancelled
Test Suite / e2e-tests (push) Has been cancelled
Test Suite / performance-tests (push) Has been cancelled
Test Suite / code-quality (push) Has been cancelled

Complete cleanup of the legacy TDD AI and issue management system, establishing clear separation of concerns as requested. All issue handling is now provided by the standalone issue-facade system.

Removed components:
- TDD AI framework (tddai/ directory and tddai_cli.py)
- Legacy issue management CLI commands and services
- Issue-related Makefile targets and helper commands
- Obsolete tests and infrastructure dependencies
- Finance modules that depended on the old issue system

Updated:
- Makefile: Removed issue-*, tdd-*, and test-from-issue commands
- CLI framework: Simplified to core functionality only
- Documentation: Added deprecation notice for old config system

The issue-facade now serves as the universal CLI for issue tracking,
providing backend-agnostic interface to GitHub, GitLab, Gitea, and
local SQLite storage as documented in issue-facade/README.md.

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-10-24 21:25:04 +02:00
parent cb94c92fc0
commit a8e5b4b044
58 changed files with 11 additions and 14628 deletions

View File

@@ -5,16 +5,8 @@ Commands handle argument parsing and delegation to services.
They contain no business logic, only CLI-specific concerns.
"""
from .workspace import WorkspaceCommands
from .issues import IssueCommands
from .project import ProjectCommands
from .export import ExportCommands
from .config import ConfigCommands
__all__ = [
'WorkspaceCommands',
'IssueCommands',
'ProjectCommands',
'ExportCommands',
'ConfigCommands'
]

View File

@@ -1,82 +0,0 @@
"""
Export and reporting CLI commands.
"""
import sys
from typing import Optional
from tddai import TddaiError
from services import ExportService
from cli.presenters import OutputFormatter
class ExportCommands:
"""Commands for data export and reporting."""
def __init__(self):
self.service = ExportService()
def issue_index(self, format_type: str = "tsv", sort_by: str = "number",
filter_state: Optional[str] = None, filter_priority: Optional[str] = None,
include_state: bool = False) -> None:
"""Output compact index of all issues for Unix processing.
Args:
format_type: Output format (tsv, csv, json, fields)
sort_by: Sort by field (number, title, priority, state, created, updated)
filter_state: Filter by state (open, closed)
filter_priority: Filter by priority (low, medium, high, critical, none)
include_state: Include state column in output
"""
try:
output = self.service.export_issues(
format_type=format_type,
sort_by=sort_by,
filter_state=filter_state,
filter_priority=filter_priority,
include_state=include_state
)
# Output directly to stdout for piping
print(output)
except TddaiError as e:
# Send error to stderr to avoid corrupting piped output
print(f"❌ Error: {e}", file=sys.stderr)
sys.exit(1)
def export_issues_csv(self, output_file: str = None) -> None:
"""Export issues in CSV format."""
try:
output = self.service.export_issues(
format_type="csv",
sort_by="number"
)
if output_file:
with open(output_file, 'w') as f:
f.write(output)
OutputFormatter.success(f"Issues exported to {output_file}")
else:
print(output)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))
def export_issues_json(self, output_file: str = None) -> None:
"""Export issues in JSON format."""
try:
output = self.service.export_issues(
format_type="json",
sort_by="number"
)
if output_file:
with open(output_file, 'w') as f:
f.write(output)
OutputFormatter.success(f"Issues exported to {output_file}")
else:
print(output)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))

View File

@@ -1,134 +0,0 @@
"""
Issue CLI commands.
"""
from typing import List, Optional, Any
from tddai import TddaiError
from services import IssueService
from cli.presenters import OutputFormatter, IssueView
class IssueCommands:
"""Commands for issue operations."""
def __init__(self) -> None:
self.service = IssueService()
def list_issues(self) -> None:
"""List all issues."""
try:
issues = self.service.list_issues()
IssueView.show_list(issues)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))
def list_open_issues(self) -> None:
"""List only open issues."""
try:
issues = self.service.list_open_issues()
IssueView.show_open_issues(issues)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))
def show_issue(self, issue_number: int) -> None:
"""Show detailed issue information."""
try:
issue_data = self.service.get_issue_details(issue_number)
IssueView.show_issue_details(issue_data)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))
def create_issue(self, title: str, body: str, issue_type: str = "enhancement") -> None:
"""Create a new issue."""
try:
OutputFormatter.info(f"Creating {issue_type} issue: {title}")
OutputFormatter.empty_line()
result = self.service.create_issue(title, body, labels=[issue_type])
IssueView.show_creation_success(result, issue_type)
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error creating issue: {e}")
def create_enhancement_issue(self, title: str, use_case: str,
technical_requirements: str = "",
acceptance_criteria: Optional[List[str]] = None,
dependencies: Optional[List[str]] = None,
priority: str = "Medium") -> None:
"""Create a structured enhancement issue."""
try:
OutputFormatter.info(f"Creating enhancement issue: {title}")
OutputFormatter.empty_line()
result = self.service.create_enhancement_issue(
title, use_case, technical_requirements,
acceptance_criteria, dependencies, priority
)
OutputFormatter.success("Enhancement issue created successfully!")
OutputFormatter.key_value("Number", f"#{result['number']}")
OutputFormatter.key_value("Title", result['title'])
OutputFormatter.key_value("Priority", priority)
if 'html_url' in result:
OutputFormatter.key_value("URL", result['html_url'])
OutputFormatter.empty_line()
print("💡 Next steps:")
print(f" - Use 'make tdd-start NUM={result['number']}' to begin work")
print(f" - Use 'make show-issue NUM={result['number']}' to view details")
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error creating enhancement issue: {e}")
def create_from_template(self, template_file: str, **kwargs: Any) -> None:
"""Create issue from template file."""
try:
OutputFormatter.info(f"Creating issue from template: {template_file}")
OutputFormatter.empty_line()
result = self.service.create_from_template(template_file, **kwargs)
OutputFormatter.success("Issue created from template successfully!")
OutputFormatter.key_value("Number", f"#{result['number']}")
OutputFormatter.key_value("Title", result['title'])
if 'html_url' in result:
OutputFormatter.key_value("URL", result['html_url'])
OutputFormatter.empty_line()
print("💡 Next steps:")
print(f" - Use 'make tdd-start NUM={result['number']}' to begin work")
print(f" - Use 'make show-issue NUM={result['number']}' to view details")
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error creating issue from template: {e}")
def close_issue(self, issue_number: int, comment: str = "") -> None:
"""Close an issue with optional comment."""
try:
OutputFormatter.info(f"Closing issue #{issue_number}")
if comment:
OutputFormatter.info(f"Comment: {comment}")
OutputFormatter.empty_line()
result = self.service.close_issue(issue_number, comment)
OutputFormatter.success(f"Issue #{issue_number} closed successfully!")
OutputFormatter.key_value("Title", result['title'])
OutputFormatter.key_value("State", result['state'])
if 'html_url' in result:
OutputFormatter.key_value("URL", result['html_url'])
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error closing issue: {e}")
def analyze_coverage(self, issue_number: int) -> None:
"""Analyze test coverage for a specific issue."""
try:
coverage_data = self.service.analyze_coverage(issue_number)
IssueView.show_coverage_analysis(coverage_data)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))

View File

@@ -1,88 +0,0 @@
"""
Project management CLI commands.
"""
from tddai import TddaiError
from services import ProjectService
from cli.presenters import OutputFormatter, ProjectView
class ProjectCommands:
"""Commands for project management operations."""
def __init__(self):
self.service = ProjectService()
def setup_project_management(self) -> None:
"""Setup project management labels and milestones."""
try:
OutputFormatter.info("Setting up project management system...")
self.service.setup_project_management()
ProjectView.show_setup_success()
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error setting up project management: {e}")
def move_issue_to_state(self, issue_number: int, state: str) -> None:
"""Move issue to a specific project state."""
try:
OutputFormatter.info(f"Moving issue #{issue_number} to {state} state...")
result = self.service.set_issue_state(issue_number, state)
# If moving to done, also close the issue
if state == 'done':
self.service.move_issue_to_done(issue_number)
OutputFormatter.success(f"Issue #{issue_number} moved to {state} and closed")
else:
OutputFormatter.success(f"Issue #{issue_number} moved to {state}")
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error moving issue to {state}: {e}")
def set_issue_priority(self, issue_number: int, priority: str) -> None:
"""Set issue priority."""
try:
OutputFormatter.info(f"Setting issue #{issue_number} priority to {priority}...")
result = self.service.set_issue_priority(issue_number, priority)
OutputFormatter.success(f"Issue #{issue_number} priority set to {priority}")
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error setting issue priority: {e}")
def create_milestone(self, title: str, description: str = "") -> None:
"""Create a new milestone (project)."""
try:
OutputFormatter.info(f"Creating milestone: {title}")
milestone = self.service.create_milestone(title, description)
OutputFormatter.success("Milestone created successfully!")
OutputFormatter.key_value("ID", milestone.id)
OutputFormatter.key_value("Title", milestone.title)
OutputFormatter.key_value("Description", milestone.description)
OutputFormatter.key_value("State", milestone.state)
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error creating milestone: {e}")
def list_milestones(self) -> None:
"""List all milestones."""
try:
milestones = self.service.list_milestones("all")
ProjectView.show_milestone_list(milestones)
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error listing milestones: {e}")
def assign_issue_to_milestone(self, issue_number: int, milestone_id: int) -> None:
"""Assign issue to a milestone."""
try:
OutputFormatter.info(f"Assigning issue #{issue_number} to milestone #{milestone_id}...")
result = self.service.assign_issue_to_milestone(issue_number, milestone_id)
OutputFormatter.success(f"Issue #{issue_number} assigned to milestone #{milestone_id}")
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error assigning issue to milestone: {e}")
def project_overview(self) -> None:
"""Show project management overview."""
try:
overview = self.service.get_project_overview()
ProjectView.show_overview(overview)
except TddaiError as e:
OutputFormatter.exit_with_error(f"Error getting project overview: {e}")

View File

@@ -1,100 +0,0 @@
"""
Workspace CLI commands.
"""
from tddai import TddaiError
from services import WorkspaceService
from cli.presenters import OutputFormatter, WorkspaceView
class WorkspaceCommands:
"""Commands for workspace operations."""
def __init__(self):
self.service = WorkspaceService()
def status(self) -> None:
"""Show current workspace status."""
try:
summary = self.service.get_workspace_summary()
WorkspaceView.show_status(summary)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))
def start_issue(self, issue_number: int) -> None:
"""Start working on an issue."""
try:
OutputFormatter.info(f"Starting work on issue #{issue_number}...")
OutputFormatter.info(f"Fetching issue #{issue_number} details...")
workspace_info = self.service.start_issue_workspace(issue_number)
summary = self.service.get_workspace_summary()
WorkspaceView.show_start_success(summary)
except TddaiError as e:
if "Already working on" in str(e):
OutputFormatter.warning(str(e))
print(" Run 'make tdd-finish' first or 'make tdd-status' to see details")
OutputFormatter.exit_with_error("Cannot start new workspace", 1)
else:
OutputFormatter.exit_with_error(str(e))
def finish_issue(self) -> None:
"""Finish current issue workspace."""
try:
issue_number = self.service.finish_current_workspace()
if issue_number is None:
OutputFormatter.error("No active issue workspace")
print(" Nothing to finish")
OutputFormatter.exit_with_error("", 1)
return # Explicit return for type checker
# Get test count before finishing
summary = self.service.get_workspace_summary()
test_count = summary.get('test_count', 0)
WorkspaceView.show_finish_success(issue_number, test_count)
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))
def add_test_guidance(self) -> None:
"""Show guidance for adding tests."""
try:
summary = self.service.get_workspace_summary()
if not summary['active']:
OutputFormatter.error("No active issue workspace")
print(" Run 'make tdd-start NUM=X' first")
OutputFormatter.exit_with_error("", 1)
issue_num = summary['issue_number']
issue_title = summary['issue_title']
workspace_dir = summary['workspace_dir']
print(f"🧪 Adding test to issue #{issue_num} workspace")
OutputFormatter.empty_line()
OutputFormatter.key_value("Issue", f"#{issue_num}: {issue_title}")
OutputFormatter.key_value("Workspace", f"{workspace_dir}/issue_{issue_num}/")
OutputFormatter.empty_line()
print("🤖 Please ask Claude Code to generate a test:")
OutputFormatter.empty_line()
print(" Command: 'Generate a test for the current workspace issue'")
OutputFormatter.empty_line()
print("📝 Test Requirements:")
print(f" - Save test in: {workspace_dir}/issue_{issue_num}/tests/")
print(f" - Name format: test_issue_{issue_num}_<scenario>.py")
print(f" - Include docstring referencing issue #{issue_num}")
print(" - Follow TDD principles (test should fail initially)")
print(" - Review requirements.md and test_plan.md for context")
OutputFormatter.empty_line()
print("📋 Issue Details:")
OutputFormatter.key_value("Title", issue_title)
# Note: Could fetch full issue details if needed
OutputFormatter.empty_line()
print("💡 After generation: Use 'make tdd-status' to see all tests")
except TddaiError as e:
OutputFormatter.exit_with_error(str(e))

View File

@@ -5,92 +5,15 @@ Provides the main CLI framework and command delegation.
"""
from typing import Any
from .commands import WorkspaceCommands, IssueCommands, ProjectCommands, ExportCommands, ConfigCommands
from .commands import ConfigCommands
class CLIFramework:
"""Main CLI framework that delegates to command classes."""
def __init__(self) -> None:
self.workspace = WorkspaceCommands()
self.issues = IssueCommands()
self.project = ProjectCommands()
self.export = ExportCommands()
self.config = ConfigCommands()
# Workspace operations
def workspace_status(self) -> None:
return self.workspace.status()
def start_issue(self, issue_number: int) -> None:
return self.workspace.start_issue(issue_number)
def finish_issue(self) -> None:
return self.workspace.finish_issue()
def add_test_guidance(self) -> None:
return self.workspace.add_test_guidance()
# Issue operations
def list_issues(self) -> None:
return self.issues.list_issues()
def list_open_issues(self) -> None:
return self.issues.list_open_issues()
def show_issue(self, issue_number: int) -> None:
return self.issues.show_issue(issue_number)
def create_issue(self, title: str, body: str, issue_type: str = "enhancement") -> None:
return self.issues.create_issue(title, body, issue_type)
def create_enhancement_issue(self, title: str, use_case: str, **kwargs: Any) -> None:
return self.issues.create_enhancement_issue(title, use_case, **kwargs)
def create_from_template(self, template_file: str, **kwargs: Any) -> None:
return self.issues.create_from_template(template_file, **kwargs)
def close_issue(self, issue_number: int, comment: str = "") -> None:
return self.issues.close_issue(issue_number, comment)
def analyze_coverage(self, issue_number: int) -> None:
return self.issues.analyze_coverage(issue_number)
# Project management operations
def setup_project_management(self) -> None:
return self.project.setup_project_management()
def move_issue_to_state(self, issue_number: int, state: str) -> None:
return self.project.move_issue_to_state(issue_number, state)
def set_issue_priority(self, issue_number: int, priority: str) -> None:
return self.project.set_issue_priority(issue_number, priority)
def create_milestone(self, title: str, description: str = "") -> None:
return self.project.create_milestone(title, description)
def list_milestones(self) -> None:
return self.project.list_milestones()
def assign_issue_to_milestone(self, issue_number: int, milestone_id: int) -> None:
return self.project.assign_issue_to_milestone(issue_number, milestone_id)
def project_overview(self) -> None:
return self.project.project_overview()
# Export operations
def issue_index(self, **kwargs: Any) -> None:
return self.export.issue_index(**kwargs)
def export_issues_csv(self, output_file: str = None) -> None:
return self.export.export_issues_csv(output_file)
def export_issues_json(self, output_file: str = None) -> None:
return self.export.export_issues_json(output_file)
def export_issue_index(self, output_file: str = None) -> None:
return self.export.issue_index(format_type="tsv", output_file=output_file)
# Configuration operations
def show_config(self, show_sensitive: bool = False) -> None:
return self.config.show_config(show_sensitive)

View File

@@ -1,180 +0,0 @@
#!/usr/bin/env python3
"""
Pure Issue Management CLI
Dedicated CLI interface for issue management operations, providing clean
separation from document processing and TDD workflow functionality.
This CLI focuses exclusively on issue operations:
- Listing and viewing issues
- Creating and closing issues
- Project management (milestones, priorities, states)
- Issue metadata and bulk operations
Architecture: Uses the unified cli/ framework for consistent command structure.
"""
import sys
import argparse
from pathlib import Path
from typing import Optional
# Add project root to path for imports
project_root = Path(__file__).parent.parent
sys.path.insert(0, str(project_root))
from cli.core import CLIFramework
from tddai import TddaiError
def create_parser() -> argparse.ArgumentParser:
"""Create argument parser for issue CLI."""
parser = argparse.ArgumentParser(
prog='issue',
description='Pure Issue Management CLI - Dedicated interface for issue operations',
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog="""
Examples:
issue list # List all issues
issue list --open # List only open issues
issue show 42 # Show issue details
issue create "Bug fix" "Description" # Create new issue
issue close 42 "Fixed the problem" # Close issue with comment
issue assign 42 milestone-1 # Assign to milestone
issue priority 42 high # Set priority
issue state 42 "In Progress" # Set project state
Focus Areas:
- Issue browsing and management
- Project organization (milestones, priorities)
- Bulk operations and metadata management
- Integration with various issue tracking backends
Related Commands:
tddai - TDD workflow management with issue context
markitect - Document processing and template operations
"""
)
subparsers = parser.add_subparsers(dest='command', help='Available issue commands')
# List issues
list_parser = subparsers.add_parser('list', help='List issues')
list_parser.add_argument('--open', action='store_true', help='Show only open issues')
list_parser.add_argument('--format', choices=['table', 'json', 'csv'], default='table', help='Output format')
# Show issue details
show_parser = subparsers.add_parser('show', help='Show issue details')
show_parser.add_argument('issue_number', type=int, help='Issue number')
# Create issue
create_parser = subparsers.add_parser('create', help='Create new issue')
create_parser.add_argument('title', help='Issue title')
create_parser.add_argument('description', help='Issue description')
create_parser.add_argument('--type', choices=['bug', 'enhancement', 'feature'], default='enhancement', help='Issue type')
create_parser.add_argument('--priority', choices=['low', 'medium', 'high', 'critical'], help='Issue priority')
# Close issue
close_parser = subparsers.add_parser('close', help='Close issue')
close_parser.add_argument('issue_number', type=int, help='Issue number')
close_parser.add_argument('comment', nargs='?', default='', help='Closing comment')
# Assign to milestone
assign_parser = subparsers.add_parser('assign', 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')
# Set priority
priority_parser = subparsers.add_parser('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')
# Set state
state_parser = subparsers.add_parser('state', help='Set issue project state')
state_parser.add_argument('issue_number', type=int, help='Issue number')
state_parser.add_argument('state', help='Project state')
# Export/bulk operations
export_parser = subparsers.add_parser('export', help='Export issues in various formats')
export_parser.add_argument('--format', choices=['csv', 'json', 'tsv'], default='csv', help='Export format')
export_parser.add_argument('--output', help='Output file (default: stdout)')
export_parser.add_argument('--filter', choices=['open', 'closed', 'all'], default='all', help='Filter issues')
# Milestones
milestone_parser = subparsers.add_parser('milestones', help='List milestones')
return parser
def main():
"""Main entry point for issue CLI."""
parser = create_parser()
args = parser.parse_args()
if not args.command:
parser.print_help()
sys.exit(1)
# Initialize CLI framework
try:
cli = CLIFramework()
except Exception as e:
print(f"Error initializing CLI framework: {e}")
sys.exit(1)
# Execute commands
try:
if args.command == 'list':
if args.open:
cli.list_open_issues()
else:
cli.list_issues()
elif args.command == 'show':
cli.show_issue(args.issue_number)
elif args.command == 'create':
kwargs = {}
if hasattr(args, 'priority') and args.priority:
kwargs['priority'] = args.priority
cli.create_issue(args.title, args.description, args.type, **kwargs)
elif args.command == 'close':
cli.close_issue(args.issue_number, args.comment)
elif args.command == 'assign':
cli.assign_issue_to_milestone(args.issue_number, args.milestone_id)
elif args.command == 'priority':
cli.set_issue_priority(args.issue_number, args.priority)
elif args.command == 'state':
cli.move_issue_to_state(args.issue_number, args.state)
elif args.command == 'export':
# Export functionality
if args.format == 'csv':
cli.export_issues_csv(args.output)
elif args.format == 'json':
cli.export_issues_json(args.output)
elif args.format == 'tsv':
cli.export_issue_index(args.output)
elif args.command == 'milestones':
cli.list_milestones()
else:
print(f"Unknown command: {args.command}")
parser.print_help()
sys.exit(1)
except TddaiError as e:
print(f"Issue CLI Error: {e}")
sys.exit(1)
except Exception as e:
print(f"Unexpected error: {e}")
sys.exit(1)
if __name__ == '__main__':
main()