moai-adk 0.8.0__py3-none-any.whl → 0.15.0__py3-none-any.whl

moai_adk/core/issue_creator.py

@@ -0,0 +1,313 @@
+"""
+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"],  # Fixed: "help-wanted" → "help wanted" (GitHub standard)
+    }
+
+    # 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(config.priority.value)  # Fixed: removed "priority-" prefix (use direct label names)
+        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 += "**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/core/project/detector.py

@@ -1,8 +1,15 @@
 # @CODE:CORE-PROJECT-001 | SPEC: SPEC-CORE-PROJECT-001.md | TEST: tests/unit/test_language_detector.py
 # @CODE:LANG-DETECT-001 | SPEC: SPEC-LANG-DETECT-001.md | TEST: tests/unit/test_detector.py
+# @CODE:LDE-EXTENDED-001 | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md | TEST: tests/unit/test_language_detector_extended.py
 """Language detector module.
 
 Automatically detects 20 programming languages.
+
+Extended detection supports:
+- 11 new languages: Ruby, PHP, Java, Rust, Dart, Swift, Kotlin, C#, C, C++, Shell
+- 5 build tool detection: Maven, Gradle, CMake, SPM, dotnet
+- Package manager detection: bundle, composer, cargo
+- Priority conflict resolution for multi-language projects
 """
 
 from pathlib import Path
@@ -16,7 +23,18 @@ class LanguageDetector:
     """
 
     LANGUAGE_PATTERNS = {
-        # Ruby moved to top for priority (Rails detection over generic frameworks)
+        # @CODE:LDE-PRIORITY-001 | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+        # Priority order (highest to lowest):
+        # 1. Rust, 2. Dart, 3. Swift, 4. Kotlin, 5. C#, 6. Java, 7. Ruby, 8. PHP
+        # 9. Go, 10. Python, 11. TypeScript, 12. JavaScript, 13. C++, 14. C, 15. Shell
+
+        "rust": ["*.rs", "Cargo.toml"],
+        "dart": ["*.dart", "pubspec.yaml"],
+        "swift": ["*.swift", "Package.swift"],
+        "kotlin": ["*.kt", "build.gradle.kts"],
+        "csharp": ["*.cs", "*.csproj"],
+        "java": ["*.java", "pom.xml", "build.gradle"],
+        # Ruby moved for priority (Rails detection)
         # @CODE:LANG-DETECT-RUBY-001 | SPEC: Issue #51 Language Detection Fix
         "ruby": [
             "*.rb",
@@ -26,7 +44,7 @@ class LanguageDetector:
             "app/controllers/",       # Rails: controller directory
             "Rakefile"                # Rails/Ruby: task file
         ],
-        # PHP moved to second for priority (Laravel detection after Rails)
+        # PHP after Ruby (Laravel detection)
         "php": [
             "*.php",
             "composer.json",
@@ -34,23 +52,18 @@ class LanguageDetector:
             "app/",                   # Laravel: application directory
             "bootstrap/laravel.php"   # Laravel: bootstrap file
         ],
+        "go": ["*.go", "go.mod"],
         "python": ["*.py", "pyproject.toml", "requirements.txt", "setup.py"],
         "typescript": ["*.ts", "tsconfig.json"],
         "javascript": ["*.js", "package.json"],
-        "java": ["*.java", "pom.xml", "build.gradle"],
-        "go": ["*.go", "go.mod"],
-        "rust": ["*.rs", "Cargo.toml"],
-        "dart": ["*.dart", "pubspec.yaml"],
-        "swift": ["*.swift", "Package.swift"],
-        "kotlin": ["*.kt", "build.gradle.kts"],
-        "csharp": ["*.cs", "*.csproj"],
+        "cpp": ["*.cpp", "CMakeLists.txt"],
+        "c": ["*.c", "Makefile"],
+        "shell": ["*.sh", "*.bash"],
+        # Additional languages (lower priority)
         "elixir": ["*.ex", "mix.exs"],
         "scala": ["*.scala", "build.sbt"],
         "clojure": ["*.clj", "project.clj"],
         "haskell": ["*.hs", "*.cabal"],
-        "c": ["*.c", "Makefile"],
-        "cpp": ["*.cpp", "CMakeLists.txt"],
-        "shell": ["*.sh", "*.bash"],
         "lua": ["*.lua"],
     }
 
@@ -112,6 +125,182 @@ class LanguageDetector:
 
         return False
 
+    def get_workflow_template_path(self, language: str) -> str:
+        """Get the GitHub Actions workflow template path for a language.
+
+        @CODE:LDE-WORKFLOW-PATH-001 | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+
+        Args:
+            language: Programming language name (lowercase).
+
+        Returns:
+            Workflow template file path relative to templates directory.
+
+        Raises:
+            ValueError: If language is not supported for workflows.
+        """
+        workflow_mapping = {
+            "python": ".github/workflows/python-tag-validation.yml",
+            "javascript": ".github/workflows/javascript-tag-validation.yml",
+            "typescript": ".github/workflows/typescript-tag-validation.yml",
+            "go": ".github/workflows/go-tag-validation.yml",
+            "ruby": ".github/workflows/ruby-tag-validation.yml",
+            "php": ".github/workflows/php-tag-validation.yml",
+            "java": ".github/workflows/java-tag-validation.yml",
+            "rust": ".github/workflows/rust-tag-validation.yml",
+            "dart": ".github/workflows/dart-tag-validation.yml",
+            "swift": ".github/workflows/swift-tag-validation.yml",
+            "kotlin": ".github/workflows/kotlin-tag-validation.yml",
+            "csharp": ".github/workflows/csharp-tag-validation.yml",
+            "c": ".github/workflows/c-tag-validation.yml",
+            "cpp": ".github/workflows/cpp-tag-validation.yml",
+            "shell": ".github/workflows/shell-tag-validation.yml",
+        }
+
+        if language.lower() not in workflow_mapping:
+            raise ValueError(
+                f"Unsupported language: {language}. "
+                f"Supported languages: {', '.join(workflow_mapping.keys())}"
+            )
+
+        return workflow_mapping[language.lower()]
+
+    def detect_package_manager(self, path: str | Path = ".") -> str | None:
+        """Detect the package manager for the detected language.
+
+        @CODE:LDE-PKG-MGR-001 | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+
+        Args:
+            path: Directory to inspect.
+
+        Returns:
+            Package manager name or None if not detected.
+        """
+        path = Path(path)
+
+        # Ruby
+        if (path / "Gemfile").exists():
+            return "bundle"
+
+        # PHP
+        if (path / "composer.json").exists():
+            return "composer"
+
+        # Java/Kotlin
+        if (path / "pom.xml").exists():
+            return "maven"
+        if (path / "build.gradle").exists() or (path / "build.gradle.kts").exists():
+            return "gradle"
+
+        # Rust
+        if (path / "Cargo.toml").exists():
+            return "cargo"
+
+        # Dart/Flutter
+        if (path / "pubspec.yaml").exists():
+            return "dart_pub"
+
+        # Swift
+        if (path / "Package.swift").exists():
+            return "spm"
+
+        # C#
+        if list(path.glob("*.csproj")) or list(path.glob("*.sln")):
+            return "dotnet"
+
+        # Python
+        if (path / "pyproject.toml").exists():
+            return "pip"
+
+        # JavaScript/TypeScript (check in priority order)
+        # Check for lock files and package managers
+        if (path / "bun.lockb").exists():
+            return "bun"
+        elif (path / "pnpm-lock.yaml").exists():
+            return "pnpm"
+        elif (path / "yarn.lock").exists():
+            return "yarn"
+        elif (path / "package-lock.json").exists():
+            return "npm"
+        elif (path / "package.json").exists():
+            # Default to npm for package.json without lock files
+            return "npm"
+
+        # Go
+        if (path / "go.mod").exists():
+            return "go_modules"
+
+        return None
+
+    def detect_build_tool(self, path: str | Path = ".", language: str | None = None) -> str | None:
+        """Detect the build tool for the detected language.
+
+        @CODE:LDE-BUILD-TOOL-001 | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+
+        Args:
+            path: Directory to inspect.
+            language: Optional language hint for disambiguation.
+
+        Returns:
+            Build tool name or None if not detected.
+        """
+        path = Path(path)
+
+        # C/C++
+        if (path / "CMakeLists.txt").exists():
+            return "cmake"
+        if (path / "Makefile").exists():
+            return "make"
+
+        # Java/Kotlin
+        if language in ["java", "kotlin"]:
+            if (path / "pom.xml").exists():
+                return "maven"
+            if (path / "build.gradle").exists() or (path / "build.gradle.kts").exists():
+                return "gradle"
+
+        # Rust
+        if (path / "Cargo.toml").exists():
+            return "cargo"
+
+        # Swift
+        if (path / "Package.swift").exists():
+            return "spm"
+        if list(path.glob("*.xcodeproj")) or list(path.glob("*.xcworkspace")):
+            return "xcode"
+
+        # C#
+        if list(path.glob("*.csproj")) or list(path.glob("*.sln")):
+            return "dotnet"
+
+        return None
+
+    def get_supported_languages_for_workflows(self) -> list[str]:
+        """Get the list of languages with dedicated CI/CD workflow support.
+
+        @CODE:LDE-SUPPORTED-LANGS-001 | SPEC: SPEC-LANGUAGE-DETECTION-EXTENDED-001/spec.md
+
+        Returns:
+            List of supported language names (15 total).
+        """
+        return [
+            "python",
+            "javascript",
+            "typescript",
+            "go",
+            "ruby",
+            "php",
+            "java",
+            "rust",
+            "dart",
+            "swift",
+            "kotlin",
+            "csharp",
+            "c",
+            "cpp",
+            "shell",
+        ]
+
 
 def detect_project_language(path: str | Path = ".") -> str | None:
     """Detect the project language (helper).

moai_adk/core/project/initializer.py

@@ -11,7 +11,9 @@ Phase-based 5-step initialization process:
 5. Validation: Verification and finalization
 """
 
+import json
 import time
+from datetime import datetime
 from pathlib import Path
 
 from moai_adk.core.project.phase_executor import PhaseExecutor, ProgressCallback
@@ -55,6 +57,62 @@ class ProjectInitializer:
         self.validator = ProjectValidator()
         self.executor = PhaseExecutor(self.validator)
 
+    def _create_memory_files(self) -> list[str]:
+        """Create runtime session and memory files (auto-generated per user/session)
+
+        Returns:
+            List of created memory files
+
+        @CODE:INIT-MEMORY-001 | Auto-generate session memory files
+        """
+        memory_dir = self.path / ".moai" / "memory"
+        memory_dir.mkdir(parents=True, exist_ok=True)
+        created_files = []
+
+        # 1. project-notes.json - Project tracking notes (empty on init)
+        project_notes = {
+            "tech_debt": [],
+            "performance_bottlenecks": [],
+            "recent_patterns": {
+                "frequent_file_edits": [],
+                "test_failures": [],
+                "git_operations": "daily commits, feature branches"
+            },
+            "next_priorities": []
+        }
+        project_notes_file = memory_dir / "project-notes.json"
+        project_notes_file.write_text(json.dumps(project_notes, indent=2))
+        created_files.append(str(project_notes_file))
+
+        # 2. session-hint.json - Last session state
+        session_hint = {
+            "last_command": None,
+            "command_timestamp": None,
+            "hours_ago": None,
+            "active_spec": None,
+            "current_branch": "main"
+        }
+        session_hint_file = memory_dir / "session-hint.json"
+        session_hint_file.write_text(json.dumps(session_hint, indent=2))
+        created_files.append(str(session_hint_file))
+
+        # 3. user-patterns.json - User preferences and expertise
+        user_patterns = {
+            "tech_preferences": {},
+            "expertise_signals": {
+                "ask_question_skip_rate": 0.0,
+                "custom_workflows": 0,
+                "estimated_level": "beginner"
+            },
+            "skip_questions": [],
+            "last_updated": datetime.now().isoformat() + "Z"
+        }
+        user_patterns_file = memory_dir / "user-patterns.json"
+        user_patterns_file.write_text(json.dumps(user_patterns, indent=2))
+        created_files.append(str(user_patterns_file))
+
+        return created_files
+
     def initialize(
         self,
         mode: str = "personal",
@@ -144,6 +202,9 @@ class ProjectInitializer:
                 self.path, mode, progress_callback
             )
 
+            # Phase 6: Create runtime memory files (auto-generated per user/session)
+            memory_files = self._create_memory_files()
+
             # Generate result
             duration = int((time.time() - start_time) * 1000)  # ms
             return InstallationResult(
@@ -153,7 +214,7 @@ class ProjectInitializer:
                 mode=mode,
                 locale=locale,
                 duration=duration,
-                created_files=resource_files + config_files,
+                created_files=resource_files + config_files + memory_files,
             )
 
         except Exception as e: