moai-adk 0.7.0__tar.gz → 0.8.1__tar.gz

{moai_adk-0.7.0 → moai_adk-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.7.0
+Version: 0.8.1
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -696,8 +696,11 @@ graph TD
 | `/alfred:1-plan <description>` | Analyze requirements, draft SPEC, write Plan Board                | `.moai/specs/SPEC-*/spec.md`, plan/acceptance docs, feature branch |
 | `/alfred:2-run <SPEC-ID>`      | Execute TDD, test/implement/refactor, verify quality              | `tests/`, `src/` implementation, quality report, TAG connection    |
 | `/alfred:3-sync`               | Sync docs/README/CHANGELOG, organize TAG/PR status                | `docs/`, `.moai/reports/sync-report.md`, Ready PR                  |
+| `/alfred:9-feedback` | Interactively create GitHub Issues (type → title → description → priority) | GitHub Issue with auto labels, priority, URL        |
 
 > ❗ All commands maintain **Phase 0 (optional) → Phase 1 → Phase 2 → Phase 3** cycle structure. Alfred automatically reports execution status and next-step suggestions.
+>
+> 💡 **New in v0.7.0+**: `/alfred:9-feedback` enables instant GitHub Issue creation during development, keeping your workflow uninterrupted while keeping issues tracked and visible to the team.
 
 ---
 
@@ -814,6 +817,125 @@ When working in your **local development environment**, CodeRabbit provides auto
 
 ---
 
+## Quick Issue Creation with `/alfred:9-feedback`
+
+MoAI-ADK v0.7.0+ includes the **Quick Issue Creation** feature, allowing developers to instantly create GitHub Issues without interrupting their development workflow.
+
+### Why Quick Issue Creation?
+
+During development, you frequently encounter:
+- 🐛 Bugs that need immediate reporting
+- ✨ Feature ideas that come to mind
+- ⚡ Performance improvements to suggest
+- ❓ Architecture questions that need team discussion
+
+**The old way**: Stop coding, go to GitHub, manually fill issue form, remember what you were working on.
+**The new way**: Type one command, GitHub Issue is created instantly, continue coding.
+
+### Interactive Dialog Flow
+
+When you run `/alfred:9-help`, Alfred guides you through an interactive multi-step dialog:
+
+**Step 1: Select Issue Type**
+```
+Alfred: What type of issue do you want to create?
+[ ] 🐛 Bug Report - Something isn't working
+[ ] ✨ Feature Request - Suggest new functionality
+[ ] ⚡ Improvement - Enhance existing features
+[ ] ❓ Question/Discussion - Ask the team
+```
+
+**Step 2: Enter Issue Title**
+```
+Alfred: What's the issue title?
+Your input: "Login button not responding to clicks"
+```
+
+**Step 3: Enter Description (Optional)**
+```
+Alfred: Provide a detailed description (optional—press Enter to skip)
+Your input: "When I click the login button on iPhone 15, it freezes for 5 seconds then crashes"
+```
+
+**Step 4: Select Priority Level**
+```
+Alfred: What's the priority level?
+[ ] 🔴 Critical - System down, data loss, security breach
+[ ] 🟠 High - Major feature broken, significant impact
+[✓] 🟡 Medium - Normal priority (default)
+[ ] 🟢 Low - Minor issues, nice-to-have
+```
+
+**Step 5: Automatic Issue Creation**
+```
+Alfred automatically:
+1. Determines appropriate labels based on issue type and priority
+2. Formats title with emoji: "🐛 [BUG] Login button not responding..."
+3. Creates GitHub Issue with all information
+4. Returns the issue number and URL
+```
+
+### Key Features
+
+1. **⚡ Instant Creation**: Create GitHub Issues in seconds
+2. **🏷️ Automatic Labels**: Issue type + priority automatically labeled
+3. **🎯 Priority Selection**: Choose from Critical/High/Medium/Low
+4. **🔗 Team Visibility**: Issues immediately visible and discussable
+5. **📋 Standardized Format**: All issues follow consistent structure
+
+### Complete Example: Bug Report During Code Review
+
+```bash
+# During code review, you notice a critical issue and want to report it instantly
+$ /alfred:9-feedback
+
+Alfred: What type of issue do you want to create?
+> 🐛 Bug Report
+
+Alfred: What's the issue title?
+> Login button crash on mobile devices
+
+Alfred: Provide a detailed description (optional—press Enter to skip)
+> Tapping the login button on iPhone 15 causes app to freeze for 5 seconds then crash.
+> Tested on iOS 17.2, Chrome 120 on macOS 14.2.
+> Expected: Login modal should appear
+> Actual: No response then crash
+
+Alfred: What's the priority level?
+> 🟠 High
+
+✅ GitHub Issue #234 created successfully!
+
+📋 Title: 🐛 [BUG] Login button crash on mobile devices
+🟠 Priority: High
+🏷️  Labels: bug, reported, priority-high
+🔗 URL: https://github.com/owner/repo/issues/234
+
+💡 Next: Continue with your work—the issue is now tracked!
+```
+
+### Integration with MoAI-ADK Workflow
+
+1. **During Development**: Use `/alfred:9-help` to report bugs/ideas instantly
+2. **In Code Review**: Convert improvement suggestions to tracked issues
+3. **When Planning**: Reference created issues in SPEC documents
+4. **During Sync**: Link issues to SPEC requirements with `/alfred:3-sync`
+
+### Prerequisites
+
+- GitHub CLI (`gh`) installed and authenticated
+- Repository initialized with Git
+
+### Learn More
+
+See `.moai/docs/quick-issue-creation-guide.md` for comprehensive documentation including:
+- Detailed usage examples
+- Best practices and tips
+- Troubleshooting guide
+- Integration with SPEC documents
+
+---
+
 ## 5 Key Concepts
 
 MoAI-ADK consists of 5 key concepts. Each concept connects to the others, and together they create a powerful development system.

{moai_adk-0.7.0 → moai_adk-0.8.1}/README.md

@@ -656,8 +656,11 @@ graph TD
 | `/alfred:1-plan <description>` | Analyze requirements, draft SPEC, write Plan Board                | `.moai/specs/SPEC-*/spec.md`, plan/acceptance docs, feature branch |
 | `/alfred:2-run <SPEC-ID>`      | Execute TDD, test/implement/refactor, verify quality              | `tests/`, `src/` implementation, quality report, TAG connection    |
 | `/alfred:3-sync`               | Sync docs/README/CHANGELOG, organize TAG/PR status                | `docs/`, `.moai/reports/sync-report.md`, Ready PR                  |
+| `/alfred:9-feedback` | Interactively create GitHub Issues (type → title → description → priority) | GitHub Issue with auto labels, priority, URL        |
 
 > ❗ All commands maintain **Phase 0 (optional) → Phase 1 → Phase 2 → Phase 3** cycle structure. Alfred automatically reports execution status and next-step suggestions.
+>
+> 💡 **New in v0.7.0+**: `/alfred:9-feedback` enables instant GitHub Issue creation during development, keeping your workflow uninterrupted while keeping issues tracked and visible to the team.
 
 ---
 
@@ -774,6 +777,125 @@ When working in your **local development environment**, CodeRabbit provides auto
 
 ---
 
+## Quick Issue Creation with `/alfred:9-feedback`
+
+MoAI-ADK v0.7.0+ includes the **Quick Issue Creation** feature, allowing developers to instantly create GitHub Issues without interrupting their development workflow.
+
+### Why Quick Issue Creation?
+
+During development, you frequently encounter:
+- 🐛 Bugs that need immediate reporting
+- ✨ Feature ideas that come to mind
+- ⚡ Performance improvements to suggest
+- ❓ Architecture questions that need team discussion
+
+**The old way**: Stop coding, go to GitHub, manually fill issue form, remember what you were working on.
+**The new way**: Type one command, GitHub Issue is created instantly, continue coding.
+
+### Interactive Dialog Flow
+
+When you run `/alfred:9-help`, Alfred guides you through an interactive multi-step dialog:
+
+**Step 1: Select Issue Type**
+```
+Alfred: What type of issue do you want to create?
+[ ] 🐛 Bug Report - Something isn't working
+[ ] ✨ Feature Request - Suggest new functionality
+[ ] ⚡ Improvement - Enhance existing features
+[ ] ❓ Question/Discussion - Ask the team
+```
+
+**Step 2: Enter Issue Title**
+```
+Alfred: What's the issue title?
+Your input: "Login button not responding to clicks"
+```
+
+**Step 3: Enter Description (Optional)**
+```
+Alfred: Provide a detailed description (optional—press Enter to skip)
+Your input: "When I click the login button on iPhone 15, it freezes for 5 seconds then crashes"
+```
+
+**Step 4: Select Priority Level**
+```
+Alfred: What's the priority level?
+[ ] 🔴 Critical - System down, data loss, security breach
+[ ] 🟠 High - Major feature broken, significant impact
+[✓] 🟡 Medium - Normal priority (default)
+[ ] 🟢 Low - Minor issues, nice-to-have
+```
+
+**Step 5: Automatic Issue Creation**
+```
+Alfred automatically:
+1. Determines appropriate labels based on issue type and priority
+2. Formats title with emoji: "🐛 [BUG] Login button not responding..."
+3. Creates GitHub Issue with all information
+4. Returns the issue number and URL
+```
+
+### Key Features
+
+1. **⚡ Instant Creation**: Create GitHub Issues in seconds
+2. **🏷️ Automatic Labels**: Issue type + priority automatically labeled
+3. **🎯 Priority Selection**: Choose from Critical/High/Medium/Low
+4. **🔗 Team Visibility**: Issues immediately visible and discussable
+5. **📋 Standardized Format**: All issues follow consistent structure
+
+### Complete Example: Bug Report During Code Review
+
+```bash
+# During code review, you notice a critical issue and want to report it instantly
+$ /alfred:9-feedback
+
+Alfred: What type of issue do you want to create?
+> 🐛 Bug Report
+
+Alfred: What's the issue title?
+> Login button crash on mobile devices
+
+Alfred: Provide a detailed description (optional—press Enter to skip)
+> Tapping the login button on iPhone 15 causes app to freeze for 5 seconds then crash.
+> Tested on iOS 17.2, Chrome 120 on macOS 14.2.
+> Expected: Login modal should appear
+> Actual: No response then crash
+
+Alfred: What's the priority level?
+> 🟠 High
+
+✅ GitHub Issue #234 created successfully!
+
+📋 Title: 🐛 [BUG] Login button crash on mobile devices
+🟠 Priority: High
+🏷️  Labels: bug, reported, priority-high
+🔗 URL: https://github.com/owner/repo/issues/234
+
+💡 Next: Continue with your work—the issue is now tracked!
+```
+
+### Integration with MoAI-ADK Workflow
+
+1. **During Development**: Use `/alfred:9-help` to report bugs/ideas instantly
+2. **In Code Review**: Convert improvement suggestions to tracked issues
+3. **When Planning**: Reference created issues in SPEC documents
+4. **During Sync**: Link issues to SPEC requirements with `/alfred:3-sync`
+
+### Prerequisites
+
+- GitHub CLI (`gh`) installed and authenticated
+- Repository initialized with Git
+
+### Learn More
+
+See `.moai/docs/quick-issue-creation-guide.md` for comprehensive documentation including:
+- Detailed usage examples
+- Best practices and tips
+- Troubleshooting guide
+- Integration with SPEC documents
+
+---
+
 ## 5 Key Concepts
 
 MoAI-ADK consists of 5 key concepts. Each concept connects to the others, and together they create a powerful development system.

{moai_adk-0.7.0 → moai_adk-0.8.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "moai-adk"
-version = "0.7.0"
+version = "0.8.1"
 description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0"
 readme = "README.md"
 requires-python = ">=3.13"

moai_adk-0.8.1/src/moai_adk/core/issue_creator.py

@@ -0,0 +1,309 @@
+"""
+GitHub Issue Creator for MoAI-ADK quick issue reporting.
+
+Enables users to quickly create GitHub Issues with standardized templates
+using `/alfred:9-feedback` interactive dialog.
+
+@TAG:ISSUE-CREATOR-001 - GitHub issue creation system
+@TAG:QUICK-REPORTING-001 - Quick issue reporting functionality
+"""
+
+import subprocess
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any, Dict, List, Optional
+
+
+class IssueType(Enum):
+    """Supported GitHub issue types."""
+    BUG = "bug"
+    FEATURE = "feature"
+    IMPROVEMENT = "improvement"
+    QUESTION = "question"
+
+
+class IssuePriority(Enum):
+    """Issue priority levels."""
+    CRITICAL = "critical"
+    HIGH = "high"
+    MEDIUM = "medium"
+    LOW = "low"
+
+
+@dataclass
+class IssueConfig:
+    """Configuration for issue creation."""
+    issue_type: IssueType
+    title: str
+    description: str
+    priority: IssuePriority = IssuePriority.MEDIUM
+    category: Optional[str] = None
+    assignees: Optional[List[str]] = None
+    custom_labels: Optional[List[str]] = None
+
+
+class GitHubIssueCreator:
+    """
+    Creates GitHub Issues using the `gh` CLI.
+
+    Supports:
+    - Multiple issue types (bug, feature, improvement, question)
+    - Priority levels and categories
+    - Standard templates for each type
+    - Label automation
+    - Priority emoji indicators
+    """
+
+    # Label mapping for issue types
+    LABEL_MAP = {
+        IssueType.BUG: ["bug", "reported"],
+        IssueType.FEATURE: ["feature-request", "enhancement"],
+        IssueType.IMPROVEMENT: ["improvement", "enhancement"],
+        IssueType.QUESTION: ["question", "help-wanted"],
+    }
+
+    # Priority emoji
+    PRIORITY_EMOJI = {
+        IssuePriority.CRITICAL: "🔴",
+        IssuePriority.HIGH: "🟠",
+        IssuePriority.MEDIUM: "🟡",
+        IssuePriority.LOW: "🟢",
+    }
+
+    # Issue type emoji
+    TYPE_EMOJI = {
+        IssueType.BUG: "🐛",
+        IssueType.FEATURE: "✨",
+        IssueType.IMPROVEMENT: "⚡",
+        IssueType.QUESTION: "❓",
+    }
+
+    def __init__(self, github_token: Optional[str] = None):
+        """
+        Initialize the GitHub Issue Creator.
+
+        Args:
+            github_token: GitHub API token. If not provided, uses GITHUB_TOKEN env var.
+        """
+        self.github_token = github_token
+        self._check_gh_cli()
+
+    def _check_gh_cli(self) -> None:
+        """
+        Check if `gh` CLI is installed and accessible.
+
+        Raises:
+            RuntimeError: If `gh` CLI is not found or not authenticated.
+        """
+        try:
+            result = subprocess.run(
+                ["gh", "auth", "status"],
+                capture_output=True,
+                text=True,
+                timeout=5
+            )
+            if result.returncode != 0:
+                raise RuntimeError(
+                    "GitHub CLI (gh) is not authenticated. "
+                    "Run `gh auth login` to authenticate."
+                )
+        except FileNotFoundError:
+            raise RuntimeError(
+                "GitHub CLI (gh) is not installed. "
+                "Please install it: https://cli.github.com"
+            )
+
+    def create_issue(self, config: IssueConfig) -> Dict[str, Any]:
+        """
+        Create a GitHub issue with the given configuration.
+
+        Args:
+            config: Issue configuration
+
+        Returns:
+            Dictionary containing issue creation result:
+            {
+                "success": bool,
+                "issue_number": int,
+                "issue_url": str,
+                "message": str
+            }
+
+        Raises:
+            RuntimeError: If issue creation fails
+        """
+        # Build title with emoji and priority
+        emoji = self.TYPE_EMOJI.get(config.issue_type, "📋")
+        priority_emoji = self.PRIORITY_EMOJI.get(config.priority, "")
+        full_title = f"{emoji} [{config.issue_type.value.upper()}] {config.title}"
+        if priority_emoji:
+            full_title = f"{priority_emoji} {full_title}"
+
+        # Build body with template
+        body = self._build_body(config)
+
+        # Collect labels
+        labels = self.LABEL_MAP.get(config.issue_type, []).copy()
+        if config.priority:
+            labels.append(f"priority-{config.priority.value}")
+        if config.category:
+            labels.append(f"category-{config.category.lower().replace(' ', '-')}")
+        if config.custom_labels:
+            labels.extend(config.custom_labels)
+
+        # Build gh command
+        gh_command = [
+            "gh", "issue", "create",
+            "--title", full_title,
+            "--body", body,
+        ]
+
+        # Add labels
+        if labels:
+            gh_command.extend(["--label", ",".join(set(labels))])
+
+        # Add assignees if provided
+        if config.assignees:
+            gh_command.extend(["--assignee", ",".join(config.assignees)])
+
+        try:
+            result = subprocess.run(
+                gh_command,
+                capture_output=True,
+                text=True,
+                timeout=30
+            )
+
+            if result.returncode != 0:
+                error_msg = result.stderr or result.stdout
+                raise RuntimeError(f"Failed to create GitHub issue: {error_msg}")
+
+            # Parse issue URL from output
+            issue_url = result.stdout.strip()
+            issue_number = self._extract_issue_number(issue_url)
+
+            return {
+                "success": True,
+                "issue_number": issue_number,
+                "issue_url": issue_url,
+                "message": f"✅ GitHub Issue #{issue_number} created successfully",
+                "title": full_title,
+                "labels": labels,
+            }
+
+        except subprocess.TimeoutExpired:
+            raise RuntimeError("GitHub issue creation timed out")
+        except Exception as e:
+            raise RuntimeError(f"Error creating GitHub issue: {e}")
+
+    def _build_body(self, config: IssueConfig) -> str:
+        """
+        Build the issue body based on issue type.
+
+        Args:
+            config: Issue configuration
+
+        Returns:
+            Formatted issue body
+        """
+        body = config.description
+
+        # Add metadata footer
+        footer = "\n\n---\n\n"
+        footer += f"**Type**: {config.issue_type.value}  \n"
+        footer += f"**Priority**: {config.priority.value}  \n"
+        if config.category:
+            footer += f"**Category**: {config.category}  \n"
+        footer += f"**Created via**: `/alfred:9-feedback`"
+
+        return body + footer
+
+    @staticmethod
+    def _extract_issue_number(url: str) -> int:
+        """
+        Extract issue number from GitHub URL.
+
+        Args:
+            url: GitHub issue URL
+
+        Returns:
+            Issue number
+
+        Raises:
+            ValueError: If unable to extract issue number
+        """
+        try:
+            # URL format: https://github.com/owner/repo/issues/123
+            return int(url.strip().split("/")[-1])
+        except (ValueError, IndexError):
+            raise ValueError(f"Unable to extract issue number from URL: {url}")
+
+    def format_result(self, result: Dict[str, Any]) -> str:
+        """
+        Format the issue creation result for display.
+
+        Args:
+            result: Issue creation result
+
+        Returns:
+            Formatted result string
+        """
+        if result["success"]:
+            output = f"{result['message']}\n"
+            output += f"📋 Title: {result['title']}\n"
+            output += f"🔗 URL: {result['issue_url']}\n"
+            if result.get("labels"):
+                output += f"🏷️  Labels: {', '.join(result['labels'])}\n"
+            return output
+        else:
+            return f"❌ Failed to create issue: {result.get('message', 'Unknown error')}"
+
+
+class IssueCreatorFactory:
+    """
+    Factory for creating issue creators with predefined configurations.
+    """
+
+    @staticmethod
+    def create_bug_issue(title: str, description: str, priority: IssuePriority = IssuePriority.HIGH) -> IssueConfig:
+        """Create a bug report issue configuration."""
+        return IssueConfig(
+            issue_type=IssueType.BUG,
+            title=title,
+            description=description,
+            priority=priority,
+            category="Bug Report",
+        )
+
+    @staticmethod
+    def create_feature_issue(title: str, description: str, priority: IssuePriority = IssuePriority.MEDIUM) -> IssueConfig:
+        """Create a feature request issue configuration."""
+        return IssueConfig(
+            issue_type=IssueType.FEATURE,
+            title=title,
+            description=description,
+            priority=priority,
+            category="Feature Request",
+        )
+
+    @staticmethod
+    def create_improvement_issue(title: str, description: str, priority: IssuePriority = IssuePriority.MEDIUM) -> IssueConfig:
+        """Create an improvement issue configuration."""
+        return IssueConfig(
+            issue_type=IssueType.IMPROVEMENT,
+            title=title,
+            description=description,
+            priority=priority,
+            category="Improvement",
+        )
+
+    @staticmethod
+    def create_question_issue(title: str, description: str, priority: IssuePriority = IssuePriority.LOW) -> IssueConfig:
+        """Create a question/discussion issue configuration."""
+        return IssueConfig(
+            issue_type=IssueType.QUESTION,
+            title=title,
+            description=description,
+            priority=priority,
+            category="Question",
+        )

{moai_adk-0.7.0 → moai_adk-0.8.1}/src/moai_adk/core/project/phase_executor.py

@@ -26,6 +26,7 @@ from moai_adk.core.project.backup_utils import (
     is_protected_path,
 )
 from moai_adk.core.project.validator import ProjectValidator
+from moai_adk.core.template.processor import TemplateProcessor
 
 console = Console()
 
@@ -136,8 +137,6 @@ class PhaseExecutor:
         )
 
         # Copy resources via TemplateProcessor in silent mode
-        from moai_adk.core.template import TemplateProcessor
-
         processor = TemplateProcessor(project_path)
 
         # Set template variable context (if provided)