refactor: remove obsolete issue management system in favor of issue-facade

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:
tegwick 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))