feat: Implement IssueWriter and formalize TDD8 methodology

SIDEQUEST ACHIEVEMENT:
- Add tddai/issue_writer.py with authenticated PATCH operations for Gitea API
- Comprehensive error handling and authentication via GITEA_TOKEN
- Clean API design: update_issue(), update_issue_title(), close_issue(), etc.
- 13 comprehensive tests covering all authentication and API scenarios
- Full integration with existing 45+ test suite (all tests pass)

METHODOLOGY BREAKTHROUGH:
- Formalize TDD8 cycle: ISSUE-TEST-RED-GREEN-REFACTOR-DOCUMENT-REFINE-PUBLISH
- Create tddai-assistant subagent with comprehensive TDD8 guidance
- Sophisticated sidequest management for blocking vs. supporting scenarios
- Complete workflow from requirements to production-ready functionality

INFRASTRUCTURE MATURITY:
- Evolution from basic TDD to comprehensive development methodology
- Clean separation of concerns and proper integration patterns
- Authoritative guidance for maintaining quality standards
- Intelligent adaptation to dynamic software development needs

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-09-23 23:41:43 +02:00
parent ddcd7f9ebb
commit ef81266eb1
4 changed files with 622 additions and 0 deletions

82
tddai/issue_writer.py Normal file
View File

@@ -0,0 +1,82 @@
"""
Issue writing to Gitea API.
"""
import json
import os
import subprocess
from subprocess import PIPE
from typing import Dict, Any, Optional
from .config import get_config
from .exceptions import IssueError
class IssueWriter:
"""Writes issue updates to Gitea API."""
def __init__(self, config=None, auth_token=None):
self.config = config or get_config()
self.auth_token = auth_token or os.getenv('GITEA_TOKEN')
def update_issue(self, issue_number: int, update_data: Dict[str, Any]) -> Dict[str, Any]:
"""Update an issue via PATCH operation."""
if not self.auth_token:
raise IssueError("Authentication token required for issue updates")
url = f"{self.config.issues_api_url}/{issue_number}"
try:
# Prepare curl command with authentication
curl_cmd = [
'curl', '-s', '-X', 'PATCH',
'-H', 'Content-Type: application/json',
'-H', f'Authorization: token {self.auth_token}',
'-d', json.dumps(update_data),
url
]
result = subprocess.run(
curl_cmd,
stdout=PIPE,
stderr=PIPE,
universal_newlines=True,
check=True
)
if result.returncode != 0:
raise IssueError(f"Failed to update issue #{issue_number}: {result.stderr}")
response_data = json.loads(result.stdout)
if 'message' in response_data and 'number' not in response_data:
raise IssueError(f"Failed to update issue #{issue_number}: {response_data['message']}")
return response_data
except subprocess.CalledProcessError as e:
raise IssueError(f"Failed to update issue #{issue_number}: {e}")
except json.JSONDecodeError as e:
raise IssueError(f"Failed to parse response data: {e}")
def update_issue_title(self, issue_number: int, new_title: str) -> Dict[str, Any]:
"""Update only the title of an issue."""
return self.update_issue(issue_number, {'title': new_title})
def update_issue_body(self, issue_number: int, new_body: str) -> Dict[str, Any]:
"""Update only the body of an issue."""
return self.update_issue(issue_number, {'body': new_body})
def update_issue_state(self, issue_number: int, new_state: str) -> Dict[str, Any]:
"""Update only the state of an issue (open/closed)."""
if new_state not in ['open', 'closed']:
raise IssueError(f"Invalid state '{new_state}'. Must be 'open' or 'closed'")
return self.update_issue(issue_number, {'state': new_state})
def close_issue(self, issue_number: int) -> Dict[str, Any]:
"""Close an issue."""
return self.update_issue_state(issue_number, 'closed')
def reopen_issue(self, issue_number: int) -> Dict[str, Any]:
"""Reopen a closed issue."""
return self.update_issue_state(issue_number, 'open')