moai-adk 0.10.1__py3-none-any.whl → 0.11.1__py3-none-any.whl

moai_adk/core/issue_creator.py

@@ -59,7 +59,7 @@ class GitHubIssueCreator:
         IssueType.BUG: ["bug", "reported"],
         IssueType.FEATURE: ["feature-request", "enhancement"],
         IssueType.IMPROVEMENT: ["improvement", "enhancement"],
-        IssueType.QUESTION: ["question", "help-wanted"],
+        IssueType.QUESTION: ["question", "help wanted"],  # Fixed: "help-wanted" → "help wanted" (GitHub standard)
     }
 
     # Priority emoji
@@ -145,7 +145,7 @@ class GitHubIssueCreator:
         # Collect labels
         labels = self.LABEL_MAP.get(config.issue_type, []).copy()
         if config.priority:
-            labels.append(f"priority-{config.priority.value}")
+            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:

moai_adk/core/project/detector.py

@@ -16,7 +16,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 +37,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 +45,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 +118,273 @@ class LanguageDetector:
 
         return False
 
+    # @CODE:LANG-002 | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/unit/test_detector.py
+    def detect_package_manager(self, path: str | Path = ".") -> str:
+        """Detect JavaScript/TypeScript package manager.
+
+        Checks for lock files in priority order (highest to lowest):
+        1. bun.lockb (Bun) - fastest runtime
+        2. pnpm-lock.yaml (pnpm) - efficient disk usage
+        3. yarn.lock (Yarn) - Facebook's package manager
+        4. package-lock.json (npm) - default Node.js package manager
+
+        Priority order reflects modern best practices and performance characteristics.
+
+        Args:
+            path: Project root directory to inspect. Defaults to current directory.
+
+        Returns:
+            Package manager name: 'bun' | 'pnpm' | 'yarn' | 'npm'
+
+        Example:
+            >>> detector = LanguageDetector()
+            >>> detector.detect_package_manager("/path/to/project")
+            'pnpm'
+        """
+        path = Path(path)
+
+        # Check in priority order (Bun → pnpm → Yarn → npm)
+        if (path / "bun.lockb").exists():
+            return "bun"
+        elif (path / "pnpm-lock.yaml").exists():
+            return "pnpm"
+        elif (path / "yarn.lock").exists():
+            return "yarn"
+        else:
+            # Default to npm (most common, works everywhere)
+            return "npm"
+
+    # @CODE:LANG-002 | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/unit/test_detector.py
+    def get_workflow_template_path(self, language: str) -> str:
+        """Get workflow template path for detected language.
+
+        Returns the relative path to the language-specific GitHub Actions workflow template.
+        These templates are pre-configured with language-specific testing tools, linting,
+        and coverage reporting.
+
+        Args:
+            language: Detected language name (lowercase).
+                      Supported: 'python', 'javascript', 'typescript', 'go'
+
+        Returns:
+            Relative path to workflow template (e.g., 'workflows/python-tag-validation.yml')
+
+        Raises:
+            ValueError: If language doesn't have a dedicated workflow template
+
+        Example:
+            >>> detector = LanguageDetector()
+            >>> detector.get_workflow_template_path("python")
+            'workflows/python-tag-validation.yml'
+        """
+        # Language-to-template mapping (add new languages here)
+        template_mapping = {
+            "python": "python-tag-validation.yml",
+            "javascript": "javascript-tag-validation.yml",
+            "typescript": "typescript-tag-validation.yml",
+            "go": "go-tag-validation.yml",
+        }
+
+        if language not in template_mapping:
+            supported = ", ".join(sorted(template_mapping.keys()))
+            raise ValueError(
+                f"Language '{language}' does not have a dedicated workflow template. "
+                f"Supported languages: {supported}"
+            )
+
+        template_filename = template_mapping[language]
+        # Return path relative to templates directory
+        return f"workflows/{template_filename}"
+
+    # @CODE:LANG-002 | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/unit/test_detector.py
+    def get_supported_languages_for_workflows(self) -> list[str]:
+        """Get list of languages with dedicated workflow templates.
+
+        Returns languages that have pre-built GitHub Actions workflow templates
+        with language-specific testing, linting, and coverage configuration.
+
+        Returns:
+            List of supported language names (lowercase)
+
+        Example:
+            >>> detector = LanguageDetector()
+            >>> detector.get_supported_languages_for_workflows()
+            ['python', 'javascript', 'typescript', 'go']
+
+        Note:
+            While LanguageDetector can detect 20+ languages, only these 4
+            have dedicated CI/CD workflow templates. Other languages fall back
+            to generic workflows.
+        """
+        return ["python", "javascript", "typescript", "go"]
+
+
+    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"No workflow template available for 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
+        if (path / "package.json").exists():
+            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/phase_executor.py

@@ -312,8 +312,12 @@ class PhaseExecutor:
                 cwd=project_path,
                 check=True,
                 capture_output=True,
+                timeout=30,  # Default timeout for git operations
             )
             # Intentionally avoid printing to keep progress output clean
+        except subprocess.TimeoutExpired:
+            # Timeout is non-fatal
+            pass
         except subprocess.CalledProcessError:
             # Only log on error; failures are non-fatal
             pass

moai_adk/core/tags/ci_validator.py

@@ -16,6 +16,8 @@ import os
 from typing import Any, Dict, List, Optional
 
 import requests
+from requests.adapters import HTTPAdapter
+from urllib3.util import Retry
 
 from .pre_commit_validator import (
     PreCommitValidator,
@@ -87,16 +89,44 @@ class CIValidator(PreCommitValidator):
             'Accept': 'application/vnd.github.v3+json'
         }
 
+        # Create session with retry strategy
+        session = requests.Session()
+        retry = Retry(
+            total=3,
+            backoff_factor=0.5,
+            status_forcelist=[500, 502, 503, 504],
+            allowed_methods=["GET"]
+        )
+        adapter = HTTPAdapter(max_retries=retry)
+        session.mount("https://", adapter)
+
         try:
-            response = requests.get(url, headers=headers, timeout=10)
+            # Dual timeout: (connect_timeout, read_timeout)
+            response = session.get(
+                url,
+                headers=headers,
+                timeout=(5, 10)
+            )
             response.raise_for_status()
 
             files_data = response.json()
             return [file_info['filename'] for file_info in files_data]
 
-        except Exception:
-            # Return empty list on any error (network, auth, etc.)
+        except requests.exceptions.Timeout:
+            # Network timeout - return empty list gracefully
+            return []
+        except requests.exceptions.HTTPError as e:
+            # HTTP error (4xx, 5xx)
+            if e.response.status_code == 404:
+                # PR not found
+                return []
+            # Other HTTP errors: log but continue
+            return []
+        except requests.exceptions.RequestException:
+            # Network/connection errors
             return []
+        finally:
+            session.close()
 
     def validate_pr_changes(
         self,

moai_adk/core/template_engine.py

@@ -31,13 +31,17 @@ class TemplateEngine:
     - File-based and string-based template rendering
     """
 
-    def __init__(self, strict_undefined: bool = False):
+    def __init__(self, strict_undefined: bool = True):
         """
         Initialize the template engine.
 
         Args:
-            strict_undefined: If True, raise error on undefined variables.
+            strict_undefined: If True, raise error on undefined variables (default: True).
                              If False, render undefined variables as empty strings.
+
+        Note:
+            Changed to strict_undefined=True (v0.10.2+) for safer template rendering.
+            Variables must be explicitly provided to avoid silent template failures.
         """
         self.strict_undefined = strict_undefined
         self.undefined_behavior = StrictUndefined if strict_undefined else None

moai_adk/templates/.claude/commands/alfred/0-project.md

@@ -96,6 +96,8 @@ The user executes the `/alfred:8-project` command to start analyzing the project
 
 **목적**: 프로젝트 초기화 시작 전에 대화 언어를 설정하고 사용자 닉네임을 등록합니다. 이 설정은 모든 Alfred 프롬프트, 인터뷰 질문 및 생성된 문서에 적용됩니다.
 
+**UX 개선**: 2개 질문을 **1회 배치 호출**로 통합 (50% 상호작용 감소: 2 turns → 1 turn)
+
 ### 0.0 Alfred 자기소개 및 환영 인사
 
 Alfred가 첫 상호작용으로 다음과 같이 인사합니다:
@@ -108,58 +110,61 @@ MoAI-ADK의 SuperAgent로서 당신의 프로젝트를 함께 만들어갈 준
 먼저 기본 설정을 진행하겠습니다.
 ```
 
-### 0.1 언어 선택
-
-Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 **첫 번째 상호작용**으로 언어 선택 메뉴를 표시합니다:
-
-**Question**:
-```
-Which language would you like to use for the project initialization and documentation?
-```
-
-**Options** (AskUserQuestion with moai-alfred-interactive-questions):
-- **English** (en) — All dialogs and documentation in English
-- **한국어** (ko) — All dialogs and documentation in Korean
-- **日本語** (ja) — All dialogs and documentation in Japanese
-- **中文** (zh) — All dialogs and documentation in Chinese
-- **Other** — User can specify custom language (e.g., "Español", "Français", "Deutsch")
-
-### 0.2 Store Language Preference
-
-Alfred records the selected language:
-
-```json
-{
-  "conversation_language": "ko",
-  "conversation_language_name": "한국어",
-  "selected_at": "2025-10-22T12:34:56Z"
-}
+### 0.1 배치 설계: 언어 선택 + 사용자 닉네임 수집 (1회 호출)
+
+Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 **단일 배치 호출**로 언어와 닉네임을 동시에 수집합니다:
+
+**Example AskUserQuestion Call**:
+```python
+AskUserQuestion(
+    questions=[
+        {
+            "question": "Which language would you like to use for the project initialization and documentation?",
+            "header": "Language",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "🌍 English",
+                    "description": "All dialogs and documentation in English"
+                },
+                {
+                    "label": "🇰🇷 한국어",
+                    "description": "All dialogs and documentation in Korean"
+                },
+                {
+                    "label": "🇯🇵 日本語",
+                    "description": "All dialogs and documentation in Japanese"
+                },
+                {
+                    "label": "🇨🇳 中文",
+                    "description": "All dialogs and documentation in Chinese"
+                }
+            ]
+        },
+        {
+            "question": "How would you like to be called in our conversations? (e.g., GOOS, Team Lead, Developer, or custom name - max 20 chars)",
+            "header": "Nickname",
+            "multiSelect": false,
+            "options": [
+                {
+                    "label": "Enter custom nickname",
+                    "description": "Type your preferred name using the 'Other' option below"
+                }
+            ]
+        }
+    ]
+)
 ```
 
-This language preference is:
-- Passed to all sub-agents as a context parameter
-- Stored in `.moai/config.json` under `language` field
-- Used to generate all documentation in the selected language
-- Displayed in CLAUDE.md under "## Project Information"
-
-### 0.2.5 사용자 닉네임 선택
-
-언어 선택 완료 후, Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 사용자 닉네임을 요청합니다:
-
-**질문**:
+**User Response Example**:
 ```
-앞으로 대화에서 당신을 어떻게 부르면 좋을까요?
-(예: GOOS, 팀장님, 개발자님, 또는 자유롭게 입력)
+Selected Language: 🇰🇷 한국어
+Selected Nickname: GOOS (typed via "Other" option)
 ```
 
-**입력 방식**:
-- 텍스트 직접 입력 가능 (자유 형식)
-- 예시: "GOOS", "팀장", "개발자" 등
-- 최대 20자 한도
-
-### 0.2.6 사용자 정보 저장
+### 0.2 사용자 정보 저장
 
-Alfred가 선택된 닉네임을 다음과 같이 저장합니다:
+Alfred가 선택된 언어와 닉네임을 다음과 같이 저장합니다:
 
 ```json
 {
@@ -172,15 +177,18 @@ Alfred가 선택된 닉네임을 다음과 같이 저장합니다:
 
 이 정보는:
 - 모든 sub-agents 에게 컨텍스트 파라미터로 전달됨
-- `.moai/config.json` 의 `user` 필드에 저장됨
-- CLAUDE.md의 `{{USER_NICKNAME}}` 변수로 치환됨
+- `.moai/config.json` 의 `language` 및 `user` 필드에 저장됨
+- CLAUDE.md의 `{{CONVERSATION_LANGUAGE}}` 및 `{{USER_NICKNAME}}` 변수로 치환됨
 - 모든 Alfred 대화에서 사용됨
 
-**예시**:
-```
-안녕하세요, GOOS님! 👋
+**설정 완료 출력 예시**:
+```markdown
+✅ 초기 설정 완료!
 
-이제 프로젝트 환경 분석으로 진행하겠습니다...
+언어: 한국어 (ko)
+닉네임: GOOS
+
+이제 GOOS님의 프로젝트 환경 분석으로 진행하겠습니다...
 ```
 
 ### 0.3 STEP 1로 전환
@@ -192,16 +200,6 @@ Alfred가 선택된 닉네임을 다음과 같이 저장합니다:
 - 생성된 문서 (product.md, structure.md, tech.md)가 선택된 언어로 작성됨
 - CLAUDE.md가 선택된 언어와 사용자 닉네임을 표시함
 
-**한국어 선택 시 출력 예시**:
-```markdown
-✅ 설정 완료!
-
-언어: 한국어 (ko)
-닉네임: GOOS
-
-이제 GOOS님의 프로젝트 환경 분석으로 진행하겠습니다...
-```
-
 ---
 
 ## 🚀 STEP 1: Environmental analysis and interview plan development

moai_adk/templates/.claude/commands/alfred/1-plan.md

@@ -22,6 +22,12 @@ allowed-tools:
 
 # 🏗️ MoAI-ADK Step 1: Establish a plan (Plan) - Always make a plan first and then proceed.
 > **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+>
+> **Batched Design**: All AskUserQuestion calls follow batched design principles (1-4 questions per call) to minimize user interaction turns. See CLAUDE.md section "Alfred Command Completion Pattern" for details.
+
+<!-- @CODE:ALF-WORKFLOW-001:CMD-PLAN -->
+
+**4-Step Workflow Integration**: This command implements Steps 1-2 of Alfred's workflow (Intent Understanding → Plan Creation). See CLAUDE.md for full workflow details.
 
 ## 🎯 Command Purpose
 

moai_adk/templates/.claude/commands/alfred/2-run.md

@@ -25,6 +25,12 @@ allowed-tools:
 
 # ⚒️ MoAI-ADK Phase 2: Run the plan - Flexible implementation strategy
 > **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+>
+> **Batched Design**: All AskUserQuestion calls follow batched design principles (1-4 questions per call) to minimize user interaction turns. See CLAUDE.md section "Alfred Command Completion Pattern" for details.
+
+<!-- @CODE:ALF-WORKFLOW-001:CMD-RUN -->
+
+**4-Step Workflow Integration**: This command implements Step 3 of Alfred's workflow (Task Execution with TodoWrite tracking). See CLAUDE.md for full workflow details.
 
 ## 🎯 Command Purpose
 

moai_adk/templates/.claude/commands/alfred/3-sync.md

@@ -23,6 +23,12 @@ allowed-tools:
 
 # 📚 MoAI-ADK Step 3: Document Synchronization (+Optional PR Ready)
 > **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+>
+> **Batched Design**: All AskUserQuestion calls follow batched design principles (1-4 questions per call) to minimize user interaction turns. See CLAUDE.md section "Alfred Command Completion Pattern" for details.
+
+<!-- @CODE:ALF-WORKFLOW-001:CMD-SYNC -->
+
+**4-Step Workflow Integration**: This command implements Step 4 of Alfred's workflow (Report & Commit with conditional report generation). See CLAUDE.md for full workflow details.
 
 ## 🚀 START HERE