coulomb/markitect-main
2
0
Fork 0
Code Issues 61 Pull Requests Actions Projects 12 Releases 1 Wiki Activity

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

Browse Source 
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:
Bernd Worsch
2025-10-24 21:25:04 +02:00
parent cb94c92fc0
commit a8e5b4b044
58 changed files with 11 additions and 14628 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
cli/commands/__init__.py
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'
]

82
cli/commands/export.py
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))

134
cli/commands/issues.py
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))

88
cli/commands/project.py
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}")

100
cli/commands/workspace.py
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))