moai-adk 0.10.1__tar.gz → 0.11.0__tar.gz

{moai_adk-0.10.1 → moai_adk-0.11.0}/.gitignore

@@ -83,4 +83,5 @@ CURSOR_INTEGRATION_PLAN.md
 .moai/reports/
 .moai/scripts/
 .moai/cache/
-
+.claude/
+.moai/

{moai_adk-0.10.1 → moai_adk-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.10.1
+Version: 0.11.0
 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
@@ -14,17 +14,21 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.13
+Requires-Python: >=3.11
 Requires-Dist: click>=8.1.0
 Requires-Dist: gitpython>=3.1.45
+Requires-Dist: jinja2>=3.0.0
 Requires-Dist: packaging>=21.0
 Requires-Dist: pyfiglet>=1.0.2
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: questionary>=2.0.0
+Requires-Dist: requests>=2.28.0
 Requires-Dist: rich>=13.0.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.7.0; extra == 'dev'
@@ -158,6 +162,22 @@ From the moment you adopt MoAI-ADK, you'll feel:
 
 ---
 
+## 🖥️ Platform Support
+
+### Supported Platforms
+- ✅ **macOS** (11.0+)
+- ✅ **Linux** (Ubuntu 20.04+, Debian 11+, etc.)
+- ✅ **Windows** (10/11) - Full support as of v0.11.0
+  - Note: Hooks system requires Python 3.11+
+  - All hook features work seamlessly on Windows with cross-platform timeout handling
+
+### System Requirements
+- **Python**: 3.11 or higher
+- **Git**: 2.30+
+- **GitHub CLI** (`gh`): Optional, required for PR automation in team mode
+
+---
+
 ## ⚡ 3-Minute Lightning Start
 
 Get your first MoAI-ADK project running in **3 simple steps**. Beginners can finish in under 5 minutes.
@@ -390,11 +410,6 @@ my-project/
 │   ├── hooks/                      # Event-driven automation
 │   │   └── alfred/
 │   │       └── alfred_hooks.py     # 5 hooks (Session, PreTool, etc.)
-│   ├── output-styles/              # Response styles
-│   │   └── alfred/
-│   │       ├── agentic-coding.md       # Professional development mode
-│   │       ├── moai-adk-learning.md    # Educational explanations mode
-│   │       └── study-with-alfred.md    # Interactive learning mode
 │   └── settings.json               # Claude Code settings
 ├── src/                            # Implementation code
 ├── tests/                          # Test code
@@ -1770,7 +1785,7 @@ The **implementation-planner** Sub-agent decides:
 
 ```python
 # tests/test_todo_api.py
-# @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
+# @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
 
 import pytest
 from src.todo.api import create_todo, get_todos
@@ -1911,7 +1926,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
 
    ```bash
    ✅ @SPEC:TODO-001 → .moai/specs/SPEC-TODO-001/spec.md
-   ✅ @TEST:TODO-001 → tests/test_todo_api.py
+   ✅ @TEST:README-EXAMPLE-TODO → tests/test_todo_api.py
    ✅ @CODE:TODO-001 → src/todo/ (3 files)
    ✅ @DOC:TODO-001 → docs/api/todo.md (auto-generated)
 
@@ -1937,7 +1952,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
    - Request: {"title": "string (1-200 chars)"}
    - Response: 201 Created with todo object
    - Implemented in: @CODE:TODO-001:API
-   - Tested in: @TEST:TODO-001
+   - Tested in: @TEST:README-EXAMPLE-TODO
 
    ### Get All Todos
 
@@ -1988,7 +2003,7 @@ rg '@(SPEC|TEST|CODE|DOC):TODO-001' -n
 
 # Output:
 # .moai/specs/SPEC-TODO-001/spec.md:1: # @SPEC:TODO-001: Todo Management API
-# tests/test_todo_api.py:2: # @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
+# tests/test_todo_api.py:2: # @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
 # src/todo/api.py:5: # @CODE:TODO-001:API | SPEC: SPEC-TODO-001.md
 # src/todo/models.py:5: # @CODE:TODO-001:MODEL | SPEC: SPEC-TODO-001.md
 # docs/api/todo.md:1: # @DOC:TODO-001: Todo Management API
@@ -2028,7 +2043,7 @@ git log --oneline | head -5
    └─ 🔴 RED: Tests written first
    └─ 🟢 GREEN: Minimal implementation
    └─ ♻️ REFACTOR: Quality improvement
-   └─ @TEST:TODO-001, @CODE:TODO-001 TAGs assigned
+   └─ @TEST:README-EXAMPLE-TODO, @CODE:TODO-001 TAGs assigned
    └─ 87% coverage, TRUST 5 principles verified
 
 ✅ Documentation sync (1 minute)
@@ -2599,7 +2614,7 @@ rg '@SPEC:HELLO-001' -n .moai/specs/
 /alfred:1-plan "feature description"
 
 # Or fix TAG in test file
-# Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:HELLO-002
+# Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:README-EXAMPLE-HELLO
 
 # 4. Sync
 /alfred:3-sync

{moai_adk-0.10.1 → moai_adk-0.11.0}/README.md

@@ -118,6 +118,22 @@ From the moment you adopt MoAI-ADK, you'll feel:
 
 ---
 
+## 🖥️ Platform Support
+
+### Supported Platforms
+- ✅ **macOS** (11.0+)
+- ✅ **Linux** (Ubuntu 20.04+, Debian 11+, etc.)
+- ✅ **Windows** (10/11) - Full support as of v0.11.0
+  - Note: Hooks system requires Python 3.11+
+  - All hook features work seamlessly on Windows with cross-platform timeout handling
+
+### System Requirements
+- **Python**: 3.11 or higher
+- **Git**: 2.30+
+- **GitHub CLI** (`gh`): Optional, required for PR automation in team mode
+
+---
+
 ## ⚡ 3-Minute Lightning Start
 
 Get your first MoAI-ADK project running in **3 simple steps**. Beginners can finish in under 5 minutes.
@@ -350,11 +366,6 @@ my-project/
 │   ├── hooks/                      # Event-driven automation
 │   │   └── alfred/
 │   │       └── alfred_hooks.py     # 5 hooks (Session, PreTool, etc.)
-│   ├── output-styles/              # Response styles
-│   │   └── alfred/
-│   │       ├── agentic-coding.md       # Professional development mode
-│   │       ├── moai-adk-learning.md    # Educational explanations mode
-│   │       └── study-with-alfred.md    # Interactive learning mode
 │   └── settings.json               # Claude Code settings
 ├── src/                            # Implementation code
 ├── tests/                          # Test code
@@ -1730,7 +1741,7 @@ The **implementation-planner** Sub-agent decides:
 
 ```python
 # tests/test_todo_api.py
-# @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
+# @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
 
 import pytest
 from src.todo.api import create_todo, get_todos
@@ -1871,7 +1882,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
 
    ```bash
    ✅ @SPEC:TODO-001 → .moai/specs/SPEC-TODO-001/spec.md
-   ✅ @TEST:TODO-001 → tests/test_todo_api.py
+   ✅ @TEST:README-EXAMPLE-TODO → tests/test_todo_api.py
    ✅ @CODE:TODO-001 → src/todo/ (3 files)
    ✅ @DOC:TODO-001 → docs/api/todo.md (auto-generated)
 
@@ -1897,7 +1908,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
    - Request: {"title": "string (1-200 chars)"}
    - Response: 201 Created with todo object
    - Implemented in: @CODE:TODO-001:API
-   - Tested in: @TEST:TODO-001
+   - Tested in: @TEST:README-EXAMPLE-TODO
 
    ### Get All Todos
 
@@ -1948,7 +1959,7 @@ rg '@(SPEC|TEST|CODE|DOC):TODO-001' -n
 
 # Output:
 # .moai/specs/SPEC-TODO-001/spec.md:1: # @SPEC:TODO-001: Todo Management API
-# tests/test_todo_api.py:2: # @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
+# tests/test_todo_api.py:2: # @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
 # src/todo/api.py:5: # @CODE:TODO-001:API | SPEC: SPEC-TODO-001.md
 # src/todo/models.py:5: # @CODE:TODO-001:MODEL | SPEC: SPEC-TODO-001.md
 # docs/api/todo.md:1: # @DOC:TODO-001: Todo Management API
@@ -1988,7 +1999,7 @@ git log --oneline | head -5
    └─ 🔴 RED: Tests written first
    └─ 🟢 GREEN: Minimal implementation
    └─ ♻️ REFACTOR: Quality improvement
-   └─ @TEST:TODO-001, @CODE:TODO-001 TAGs assigned
+   └─ @TEST:README-EXAMPLE-TODO, @CODE:TODO-001 TAGs assigned
    └─ 87% coverage, TRUST 5 principles verified
 
 ✅ Documentation sync (1 minute)
@@ -2559,7 +2570,7 @@ rg '@SPEC:HELLO-001' -n .moai/specs/
 /alfred:1-plan "feature description"
 
 # Or fix TAG in test file
-# Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:HELLO-002
+# Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:README-EXAMPLE-HELLO
 
 # 4. Sync
 /alfred:3-sync

{moai_adk-0.10.1 → moai_adk-0.11.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "moai-adk"
-version = "0.10.1"
+version = "0.11.0"
 description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0"
 readme = "README.md"
-requires-python = ">=3.13"
+requires-python = ">=3.11"
 license = {text = "MIT"}
 authors = [
     {name = "MoAI Team", email = "support@moduai.kr"}
@@ -14,6 +14,8 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Software Development :: Quality Assurance",
@@ -26,7 +28,9 @@ dependencies = [
     "questionary>=2.0.0",
     "gitpython>=3.1.45",
     "packaging>=21.0",
-    "pyyaml>=6.0"
+    "pyyaml>=6.0",
+    "jinja2>=3.0.0",
+    "requests>=2.28.0"
 ]
 
 [project.optional-dependencies]
@@ -64,7 +68,7 @@ fail_under = 85
 
 [tool.ruff]
 line-length = 120
-target-version = "py313"
+target-version = "py311"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N"]

{moai_adk-0.10.1 → moai_adk-0.11.0}/src/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-0.10.1 → moai_adk-0.11.0}/src/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-0.10.1 → moai_adk-0.11.0}/src/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-0.10.1 → moai_adk-0.11.0}/src/moai_adk/templates/.github/workflows/moai-gitflow.yml

@@ -13,6 +13,11 @@ jobs:
   moai-pipeline:
     name: "{{PROJECT_NAME}} Pipeline"
     runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -22,7 +27,7 @@ jobs:
         if: ${{ hashFiles('requirements.txt') != '' || hashFiles('pyproject.toml') != '' || hashFiles('setup.py') != '' }}
         uses: actions/setup-python@v5
         with:
-          python-version: "3.13"
+          python-version: ${{ matrix.python-version }}
 
       - name: Setup Node.js
         if: ${{ hashFiles('package.json') != '' }}

{moai_adk-0.10.1 → moai_adk-0.11.0}/src/moai_adk/templates/.github/workflows/release.yml

@@ -10,14 +10,18 @@ jobs:
     name: 📦 Deploy to PyPI
     runs-on: ubuntu-latest
 
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
     steps:
       - name: 📥 Checkout code
         uses: actions/checkout@v4
 
-      - name: 🐍 Setup Python 3.13
+      - name: 🐍 Setup Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
-          python-version: "3.13"
+          python-version: ${{ matrix.python-version }}
 
       - name: 📦 Install uv
         uses: astral-sh/setup-uv@v2

{moai_adk-0.10.1 → moai_adk-0.11.0}/src/moai_adk/templates/.github/workflows/tag-validation.yml

@@ -10,9 +10,39 @@ on:
     branches: [main, develop, "feature/**"]
 
 jobs:
+  detect-language:
+    name: 🔍 Detect Project Language
+    runs-on: ubuntu-latest
+    outputs:
+      language: ${{ steps.detect.outputs.language }}
+      is-python: ${{ steps.detect.outputs.is-python }}
+      is-javascript: ${{ steps.detect.outputs.is-javascript }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Detect language
+        id: detect
+        run: |
+          if [ -f "pyproject.toml" ] || [ -f "setup.py" ] || [ -f "requirements.txt" ]; then
+            echo "language=python" >> $GITHUB_OUTPUT
+            echo "is-python=true" >> $GITHUB_OUTPUT
+            echo "is-javascript=false" >> $GITHUB_OUTPUT
+          elif [ -f "package.json" ]; then
+            echo "language=javascript" >> $GITHUB_OUTPUT
+            echo "is-python=false" >> $GITHUB_OUTPUT
+            echo "is-javascript=true" >> $GITHUB_OUTPUT
+          else
+            echo "language=unknown" >> $GITHUB_OUTPUT
+            echo "is-python=false" >> $GITHUB_OUTPUT
+            echo "is-javascript=false" >> $GITHUB_OUTPUT
+          fi
+
   validate-tags:
     name: 🏷️ Validate TAG Annotations
     runs-on: ubuntu-latest
+    needs: detect-language
 
     # Skip validation on draft PRs (allow WIP)
     if: github.event.pull_request.draft == false || github.event_name == 'push'
@@ -21,26 +51,41 @@ jobs:
       contents: read
       pull-requests: write
 
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+        node-version: ["18", "20"]
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
           fetch-depth: 0  # Fetch all history for comprehensive validation
 
-      - name: Setup Python
+      - name: Setup Python (if Python project)
+        if: needs.detect-language.outputs.is-python == 'true'
         uses: actions/setup-python@v5
         with:
-          python-version: '3.13'
+          python-version: ${{ matrix.python-version }}
 
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
+      - name: Setup Node.js (if JavaScript project)
+        if: needs.detect-language.outputs.is-javascript == 'true'
+        uses: actions/setup-node@v4
         with:
-          version: "latest"
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install dependencies (Python)
+        if: needs.detect-language.outputs.is-python == 'true'
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install requests
 
-      - name: Install dependencies
+      - name: Install dependencies (JavaScript)
+        if: needs.detect-language.outputs.is-javascript == 'true'
         run: |
-          uv pip install --system -e .
-          uv pip install --system requests
+          npm ci
+          npm install requests 2>/dev/null || true
 
       - name: Get PR number
         id: pr