moai-adk 0.7.0__py3-none-any.whl → 0.8.1__py3-none-any.whl

moai_adk/templates/.claude/hooks/alfred/core/project.py

@@ -5,11 +5,44 @@ Project information inquiry (language, Git, SPEC progress, etc.)
 """
 
 import json
+import signal
 import subprocess
+from contextlib import contextmanager
 from pathlib import Path
 from typing import Any
 
 
+class TimeoutError(Exception):
+    """Signal-based timeout exception"""
+    pass
+
+
+@contextmanager
+def timeout_handler(seconds: int):
+    """Hard timeout using SIGALRM (works on Unix systems including macOS)
+
+    This uses kernel-level signal to interrupt ANY blocking operation,
+    even if subprocess.run() timeout fails on macOS.
+
+    Args:
+        seconds: Timeout duration in seconds
+
+    Raises:
+        TimeoutError: If operation exceeds timeout
+    """
+    def _handle_timeout(signum, frame):
+        raise TimeoutError(f"Operation timed out after {seconds} seconds")
+
+    # Set the signal handler
+    old_handler = signal.signal(signal.SIGALRM, _handle_timeout)
+    signal.alarm(seconds)
+    try:
+        yield
+    finally:
+        signal.alarm(0)  # Disable alarm
+        signal.signal(signal.SIGALRM, old_handler)
+
+
 def detect_language(cwd: str) -> str:
     """Detect project language (supports 20 items languages)
 
@@ -89,9 +122,10 @@ def detect_language(cwd: str) -> str:
 
 
 def _run_git_command(args: list[str], cwd: str, timeout: int = 2) -> str:
-    """Git command execution helper function
+    """Git command execution with HARD timeout protection
 
     Safely execute Git commands and return output.
+    Uses SIGALRM (kernel-level interrupt) to handle macOS subprocess timeout bug.
     Eliminates code duplication and provides consistent error handling.
 
     Args:
@@ -103,29 +137,46 @@ def _run_git_command(args: list[str], cwd: str, timeout: int = 2) -> str:
         Git command output (stdout, removing leading and trailing spaces)
 
     Raises:
-        subprocess.TimeoutExpired: Timeout exceeded
+        subprocess.TimeoutExpired: Timeout exceeded (via TimeoutError)
         subprocess.CalledProcessError: Git command failed
 
     Examples:
         >>> _run_git_command(["branch", "--show-current"], ".")
         'main'
+
+    TDD History:
+        - RED: Git command hang scenario test
+        - GREEN: SIGALRM-based timeout implementation
+        - REFACTOR: Exception conversion to subprocess.TimeoutExpired
     """
-    result = subprocess.run(
-        ["git"] + args,
-        cwd=cwd,
-        capture_output=True,
-        text=True,
-        timeout=timeout,
-        check=True,
-    )
-    return result.stdout.strip()
+    try:
+        with timeout_handler(timeout):
+            result = subprocess.run(
+                ["git"] + args,
+                cwd=cwd,
+                capture_output=True,
+                text=True,
+                check=False,  # Don't raise on non-zero exit - we'll check manually
+            )
+
+            # Check exit code manually
+            if result.returncode != 0:
+                raise subprocess.CalledProcessError(
+                    result.returncode, ["git"] + args, result.stdout, result.stderr
+                )
+
+            return result.stdout.strip()
+
+    except TimeoutError:
+        # Convert to subprocess.TimeoutExpired for consistent error handling
+        raise subprocess.TimeoutExpired(["git"] + args, timeout)
 
 
 def get_git_info(cwd: str) -> dict[str, Any]:
     """Gather Git repository information
 
     View the current status of a Git repository.
-    Returns the branch name, commit hash, and number of changes.
+    Returns the branch name, commit hash, number of changes, and last commit message.
     If it is not a Git repository, it returns an empty dictionary.
 
     Args:
@@ -136,12 +187,13 @@ def get_git_info(cwd: str) -> dict[str, Any]:
         - branch: Current branch name (str)
         - commit: Current commit hash (str, full hash)
         - changes: Number of changed files (int, staged + unstaged)
+        - last_commit: Last commit message (str, subject only)
 
         Empty dictionary {} if it is not a Git repository or the query fails.
 
     Examples:
         >>> get_git_info("/path/to/git/repo")
-        {'branch': 'main', 'commit': 'abc123...', 'changes': 3}
+        {'branch': 'main', 'commit': 'abc123...', 'changes': 3, 'last_commit': 'Fix bug'}
         >>> get_git_info("/path/to/non-git")
         {}
 
@@ -149,11 +201,13 @@ def get_git_info(cwd: str) -> dict[str, Any]:
         - Timeout: 2 seconds for each Git command
         - Security: Safe execution with subprocess.run(shell=False)
         - Error handling: Returns an empty dictionary in case of all exceptions
+        - Commit message limited to 50 characters for display purposes
 
     TDD History:
         - RED: 3 items scenario test (Git repo, non-Git, error)
         - GREEN: Implementation of subprocess-based Git command execution
         - REFACTOR: Add timeout (2 seconds), strengthen exception handling, remove duplicates with helper function
+        - UPDATE: Added last_commit message field for SessionStart display
     """
     try:
         # Check if it's a git repository
@@ -165,10 +219,16 @@ def get_git_info(cwd: str) -> dict[str, Any]:
         status_output = _run_git_command(["status", "--short"], cwd)
         changes = len([line for line in status_output.splitlines() if line])
 
+        # Get last commit message (subject only, limited to 50 chars)
+        last_commit = _run_git_command(["log", "-1", "--format=%s"], cwd)
+        if len(last_commit) > 50:
+            last_commit = last_commit[:47] + "..."
+
         return {
             "branch": branch,
             "commit": commit,
             "changes": changes,
+            "last_commit": last_commit,
         }
 
     except (subprocess.TimeoutExpired, subprocess.CalledProcessError, FileNotFoundError):
@@ -276,9 +336,81 @@ def get_project_language(cwd: str) -> str:
     return detect_language(cwd)
 
 
+def get_package_version_info() -> dict[str, Any]:
+    """Check MoAI-ADK current and latest version from PyPI
+
+    Compares the installed version with the latest version available on PyPI.
+    Returns version information for SessionStart hook to display update recommendations.
+
+    Returns:
+        dict with keys:
+            - "current": Current installed version
+            - "latest": Latest version available on PyPI
+            - "update_available": Boolean indicating if update is available
+            - "upgrade_command": Recommended upgrade command (if update available)
+
+    Note:
+        - Has 1-second timeout to avoid blocking SessionStart
+        - Returns graceful fallback if PyPI check fails
+        - Handles version parsing gracefully
+    """
+    import urllib.error
+    import urllib.request
+    from importlib.metadata import PackageNotFoundError, version
+
+    result = {
+        "current": "unknown",
+        "latest": "unknown",
+        "update_available": False,
+        "upgrade_command": ""
+    }
+
+    # Get current version
+    try:
+        result["current"] = version("moai-adk")
+    except PackageNotFoundError:
+        result["current"] = "dev"
+        return result
+
+    # Get latest version from PyPI (with 1-second timeout)
+    try:
+        with timeout_handler(1):
+            url = "https://pypi.org/pypi/moai-adk/json"
+            headers = {"Accept": "application/json"}
+            req = urllib.request.Request(url, headers=headers)
+            with urllib.request.urlopen(req, timeout=0.8) as response:
+                data = json.load(response)
+                result["latest"] = data.get("info", {}).get("version", "unknown")
+    except (urllib.error.URLError, TimeoutError, Exception):
+        # Network error or timeout - return with unknown latest version
+        return result
+
+    # Compare versions (simple comparison)
+    if result["current"] != "unknown" and result["latest"] != "unknown":
+        try:
+            # Parse versions for comparison
+            current_parts = [int(x) for x in result["current"].split(".")]
+            latest_parts = [int(x) for x in result["latest"].split(".")]
+
+            # Pad shorter version with zeros
+            max_len = max(len(current_parts), len(latest_parts))
+            current_parts.extend([0] * (max_len - len(current_parts)))
+            latest_parts.extend([0] * (max_len - len(latest_parts)))
+
+            if latest_parts > current_parts:
+                result["update_available"] = True
+                result["upgrade_command"] = f"uv pip install --upgrade moai-adk>={result['latest']}"
+        except (ValueError, AttributeError):
+            # Version parsing failed - skip comparison
+            pass
+
+    return result
+
+
 __all__ = [
     "detect_language",
     "get_git_info",
     "count_specs",
     "get_project_language",
+    "get_package_version_info",
 ]

moai_adk/templates/.claude/hooks/alfred/handlers/session.py

@@ -6,14 +6,16 @@ SessionStart, SessionEnd event handling
 
 from core import HookPayload, HookResult
 from core.checkpoint import list_checkpoints
-from core.project import count_specs, detect_language, get_git_info
+from core.project import count_specs, detect_language, get_git_info, get_package_version_info
 
 
 def handle_session_start(payload: HookPayload) -> HookResult:
-    """SessionStart event handler (with Checkpoint list)
+    """SessionStart event handler with GRACEFUL DEGRADATION
 
     When Claude Code Session starts, it displays a summary of project status.
     You can check the language, Git status, SPEC progress, and checkpoint list at a glance.
+    All optional operations are wrapped in try-except to ensure hook completes quickly even if
+    Git commands, file I/O, or other operations timeout or fail.
 
     Args:
         payload: Claude Code event payload (cwd key required)
@@ -24,15 +26,23 @@ def handle_session_start(payload: HookPayload) -> HookResult:
     Message Format:
         🚀 MoAI-ADK Session Started
            Language: {language}
-           Branch: {branch} ({commit hash})
-           Changes: {Number of Changed Files}
-           SPEC Progress: {Complete}/{Total} ({percent}%)
-           Checkpoints: {number} available (showing the latest 3 items)
+           [Branch: {branch} ({commit hash})] - optional if git fails
+           [Changes: {Number of Changed Files}] - optional if git fails
+           [SPEC Progress: {Complete}/{Total} ({percent}%)] - optional if specs fail
+           [Checkpoints: {number} available] - optional if checkpoint list fails
+
+    Graceful Degradation Strategy:
+        - CRITICAL: Language detection (must succeed - no try-except)
+        - OPTIONAL: Git info (skip if timeout/failure)
+        - OPTIONAL: SPEC progress (skip if timeout/failure)
+        - OPTIONAL: Checkpoint list (skip if timeout/failure)
+        - Always display SOMETHING to user, never return empty message
 
     Note:
         - Claude Code processes SessionStart in several stages (clear → compact)
         - Display message only at "compact" stage to prevent duplicate output
         - "clear" step returns minimal result (empty hookSpecificOutput)
+        - CRITICAL: All optional operations must complete within 2-3 seconds total
 
     TDD History:
         - RED: Session startup message format test
@@ -40,8 +50,10 @@ def handle_session_start(payload: HookPayload) -> HookResult:
         - REFACTOR: Improved message format, improved readability, added checkpoint list
         - FIX: Prevent duplicate output of clear step (only compact step is displayed)
         - UPDATE: Migrated to Claude Code standard Hook schema
+        - HOTFIX: Add graceful degradation for timeout scenarios (Issue #66)
 
     @TAG:CHECKPOINT-EVENT-001
+    @TAG:HOOKS-TIMEOUT-001
     """
     # Claude Code SessionStart runs in several stages (clear, compact, etc.)
     # Ignore the "clear" stage and output messages only at the "compact" stage
@@ -51,32 +63,90 @@ def handle_session_start(payload: HookPayload) -> HookResult:
         return HookResult(continue_execution=True)
 
     cwd = payload.get("cwd", ".")
+
+    # CRITICAL: Language detection - MUST succeed (no try-except)
     language = detect_language(cwd)
-    git_info = get_git_info(cwd)
-    specs = count_specs(cwd)
-    checkpoints = list_checkpoints(cwd, max_count=10)
 
-    branch = git_info.get("branch", "N/A")
-    commit = git_info.get("commit", "N/A")[:7]
-    changes = git_info.get("changes", 0)
-    spec_progress = f"{specs['completed']}/{specs['total']}"
+    # OPTIONAL: Git info - skip if timeout/failure
+    git_info = {}
+    try:
+        git_info = get_git_info(cwd)
+    except Exception:
+        # Graceful degradation - continue without git info
+        pass
+
+    # OPTIONAL: SPEC progress - skip if timeout/failure
+    specs = {"completed": 0, "total": 0, "percentage": 0}
+    try:
+        specs = count_specs(cwd)
+    except Exception:
+        # Graceful degradation - continue without spec info
+        pass
+
+    # OPTIONAL: Checkpoint list - skip if timeout/failure
+    checkpoints = []
+    try:
+        checkpoints = list_checkpoints(cwd, max_count=10)
+    except Exception:
+        # Graceful degradation - continue without checkpoints
+        pass
+
+    # OPTIONAL: Package version info - skip if timeout/failure
+    version_info = {}
+    try:
+        version_info = get_package_version_info()
+    except Exception:
+        # Graceful degradation - continue without version info
+        pass
+
+    # Build message with available information
+    branch = git_info.get("branch", "N/A") if git_info else "N/A"
+    commit = git_info.get("commit", "N/A")[:7] if git_info else "N/A"
+    changes = git_info.get("changes", 0) if git_info else 0
+    spec_progress = f"{specs['completed']}/{specs['total']}" if specs["total"] > 0 else "0/0"
 
     # system_message: displayed directly to the user
     lines = [
         "🚀 MoAI-ADK Session Started",
-        f"   Language: {language}",
-        f"   Branch: {branch} ({commit})",
-        f"   Changes: {changes}",
-        f"   SPEC Progress: {spec_progress} ({specs['percentage']}%)",
+        "",  # Blank line after title
     ]
 
+    # Add version info first (at the top, right after title)
+    if version_info and version_info.get("current") != "unknown":
+        version_line = f"   🗿 MoAI-ADK Ver: {version_info['current']}"
+        if version_info.get("update_available"):
+            version_line += f" → {version_info['latest']} available ✨"
+        lines.append(version_line)
+
+        # Add upgrade recommendation if update is available
+        if version_info.get("update_available") and version_info.get("upgrade_command"):
+            lines.append(f"   ⬆️ Upgrade: {version_info['upgrade_command']}")
+
+    # Add language info
+    lines.append(f"   🐍 Language: {language}")
+
+    # Add Git info only if available (not degraded)
+    if git_info:
+        lines.append(f"   🌿 Branch: {branch} ({commit})")
+        lines.append(f"   📝 Changes: {changes}")
+
+        # Add last commit message if available
+        last_commit = git_info.get("last_commit", "")
+        if last_commit:
+            lines.append(f"   🔨 Last: {last_commit}")
+
     # Add Checkpoint list (show only the latest 3 items)
     if checkpoints:
-        lines.append(f"   Checkpoints: {len(checkpoints)} available")
+        lines.append(f"   🗂️  Checkpoints: {len(checkpoints)} available")
         for cp in reversed(checkpoints[-3:]):  # Latest 3 items
             branch_short = cp["branch"].replace("before-", "")
-            lines.append(f"      - {branch_short}")
-        lines.append("   Restore: /alfred:0-project restore")
+            lines.append(f"      📌 {branch_short}")
+        lines.append("")  # Blank line before restore command
+        lines.append("   ↩️  Restore: /alfred:0-project restore")
+
+    # Add SPEC progress only if available (not degraded) - at the bottom
+    if specs["total"] > 0:
+        lines.append(f"   📋 SPEC Progress: {spec_progress} ({specs['percentage']}%)")
 
     system_message = "\n".join(lines)
 

moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md

@@ -8,7 +8,7 @@ description: "Agent-based coding mode that integrates hands-on development and c
 ---
 
 # Agentic Coding
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 **Audience**: Professional developers, team leaders, architects
 

moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md

@@ -8,7 +8,7 @@ description: "Learning mode to easily learn MoAI-ADK concepts and workflow"
 ---
 
 # MoAI ADK Learning
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 **Audience**: Developers new to MoAI-ADK
 

moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md

@@ -8,7 +8,7 @@ description: "Learning mode to easily learn new skills with Alfred"
 ---
 
 # Study with Alfred
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 **Audience**: Developers looking to learn new technologies/languages/frameworks
 

moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml

@@ -170,7 +170,9 @@ body:
       value: |
         ## 📚 Reference
 
-        - **SPEC Metadata Guide**: See `.moai/memory/spec-metadata.md`
-        - **EARS Syntax Guide**: See `.moai/memory/development-guide.md`
+        - **SPEC Metadata Guide**: See `{{DOCS_DIR}}/spec-metadata.md`
+        - **EARS Syntax Guide**: See `{{DOCS_DIR}}/development-guide.md`
         - **Acceptance Criteria**: Use Given-When-Then (Gherkin) format
-        - **@TAG System**: @SPEC, @TEST, @CODE, @DOC traceability
+        {% if ENABLE_TAG_SYSTEM -%}
+        - **Traceability System**: @SPEC, @TEST, @CODE, @DOC traceability
+        {% endif -%}

moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,20 +1,25 @@
-# MoAI-ADK GitFlow PR
+# {{PROJECT_NAME}} GitFlow PR
 
-> 🗿 Full GitFlow Transparency — the agent auto-fills information
+> Full GitFlow Transparency — the agent auto-fills information
 
 ## 📝 SPEC Info
 
 - Related SPEC: `SPEC-AUTH-001` (e.g., JWT authentication system)
-- Directory: `.moai/specs/SPEC-AUTH-001/`
+- Directory: `{{SPEC_DIR}}/SPEC-AUTH-001/`
+{% if ENABLE_TAG_SYSTEM -%}
 - @TAG Links: @SPEC:AUTH-001 @CODE:AUTH-001 (auto-tagging)
+{% endif -%}
 
 ## ✅ SPEC Quality Checks
 
 - [ ] YAML Front Matter: 7 required fields (id, version, status, created, updated, author, priority)
 - [ ] HISTORY Section: Record versioned change log (include v0.0.1 INITIAL)
 - [ ] EARS Requirements: Ubiquitous, Event-driven, State-driven, Optional, Constraints
+{% if ENABLE_TAG_SYSTEM -%}
 - [ ] @SPEC:ID TAG: Include TAG in doc and check duplicates (`rg "@SPEC:<ID>" -n`)
+{% endif -%}
 
+{% if ENABLE_ALFRED_COMMANDS -%}
 ## 🤖 Automated Validation Status
 
 <!-- The checklist below is auto-updated by the agent -->
@@ -25,24 +30,29 @@
 - [ ] spec-builder: Complete EARS spec and create feature branch
 - [ ] code-builder: Finish TDD RED-GREEN-REFACTOR
 - [ ] doc-syncer: Sync Living Documents and mark PR Ready
+{% endif -%}
 
+{% if ENABLE_TRUST_5 -%}
 ## 📊 Quality Metrics (auto-calculated)
 
 - TRUST 5 Principles: ✅ Compliant
 - Test Coverage: XX% (target ≥ 85%)
+{% if ENABLE_TAG_SYSTEM -%}
 - @TAG Traceability: 100%
+{% endif -%}
+{% endif -%}
 
 ## 🌍 Locale Settings
 
-- Project Language: <!-- ko/en/ja/zh -->
+- Project Language: {{CONVERSATION_LANGUAGE}}
 - Commit Messages: <!-- generated automatically according to locale -->
 
 ## 🎯 Changes
 
-<!-- code-builder auto-fills TDD results -->
+<!-- auto-fills TDD results -->
 
 ### 🔴 RED (Test Authoring)
-- Test File: `tests/auth/service.test.ts`
+- Test File: `{{TEST_DIR}}/auth/service.test.ts`
 - Test Description: [describe the failing test]
 
 ### 🟢 GREEN (Implementation)
@@ -58,12 +68,14 @@
 
 - [ ] Update README
 - [ ] Sync API docs
+{% if ENABLE_TAG_SYSTEM -%}
 - [ ] Update TAG index
+{% endif -%}
 - [ ] Update HISTORY section (SPEC docs)
 
 ---
 
-🚀 MoAI-ADK: Professional development without Git commands via a 3-stage pipeline!
+🚀 {{PROJECT_NAME}}: Professional development via a 3-stage pipeline!
 
-Reviewers: Check TRUST 5 compliance and SPEC metadata completeness only.
+Reviewers: Check quality compliance and SPEC metadata completeness only.
 

moai_adk/templates/.github/workflows/moai-gitflow.yml

@@ -1,6 +1,6 @@
-name: MoAI-ADK GitFlow Automation
+name: "{{PROJECT_NAME}} GitFlow Automation"
 
-# MoAI-ADK 3-stage pipeline: spec → build → sync
+# {{PROJECT_NAME}} 3-stage pipeline: spec → build → sync
 # Full GitFlow transparency — no Git expertise needed
 
 on:
@@ -11,7 +11,7 @@ on:
 
 jobs:
   moai-pipeline:
-    name: 🗿 MoAI-ADK Pipeline
+    name: "{{PROJECT_NAME}} Pipeline"
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -86,13 +86,13 @@ jobs:
           distribution: "temurin"
           java-version: "21"
 
-      # TRUST 5 Principles — automated validation
-      # Note: Validation is handled by TypeScript-based tools
-      - name: 🧭 TRUST 5 Principles Check
+      # TRUST 5 Principles — automated validation (if enabled)
+      {% if ENABLE_TRUST_5 -%}
+      - name: 🧭 Quality Principles Check
         run: |
-          echo "✅ TRUST validation is performed by TypeScript-based tools"
-          echo "   - Uses @agent-trust-checker"
-          echo "   - Leverages TypeScript hook system"
+          echo "✅ Quality validation is performed"
+          echo "   - Automated quality checks enabled"
+      {% endif -%}
 
       # Ignore test failures on Draft PRs; fail CI on Ready PRs
       - name: Run language-aware tests
@@ -221,11 +221,14 @@ jobs:
             fi
           fi
 
-      # TAG system validation (code files only)
-      - name: 🏷️ TAG System Validation
+      # TAG system validation (if enabled)
+      {% if ENABLE_TAG_SYSTEM -%}
+      - name: 🏷️ Traceability Validation
         run: |
-          echo "✅ TAG validation is handled automatically in the tag_validator.py hook"
+          echo "✅ Traceability validation is handled automatically"
+      {% endif -%}
 
+      {% if ENABLE_ALFRED_COMMANDS -%}
       # Run per-branch stages
       - name: 📝 SPEC Stage (feature branch)
         if: startsWith(github.ref, 'refs/heads/feature/')
@@ -239,7 +242,9 @@ jobs:
         run: |
           echo "📝 Draft PR: TDD implementation stage"
           echo "- code-builder agent runs RED-GREEN-REFACTOR"
-          echo "- Validate TRUST 5 Principles compliance"
+          {% if ENABLE_TRUST_5 -%}
+          echo "- Validate Quality Principles compliance"
+          {% endif -%}
 
       - name: 📚 SYNC Stage (Ready PR)
         if: github.event.pull_request.draft == false && github.event.action == 'ready_for_review'
@@ -247,10 +252,11 @@ jobs:
           echo "✅ Ready PR: documentation sync stage"
           echo "- doc-syncer agent synchronizes Living Documents"
           echo "- PR is ready for review"
+      {% endif -%}
 
       # Final result report
-      - name: 📊 MoAI Pipeline Complete
+      - name: "🎯 {{PROJECT_NAME}} Pipeline Complete"
         run: |
-          echo "🗿 MoAI-ADK GitFlow automation complete"
-          echo "✨ Professional workflow without needing to know Git"
+          echo "{{PROJECT_NAME}} GitFlow automation complete"
+          echo "✨ Professional workflow enabled"
 

moai_adk/templates/.github/workflows/spec-issue-sync.yml

@@ -3,7 +3,7 @@ name: 📋 SPEC Issue Sync
 on:
   pull_request:
     paths:
-      - '.moai/specs/SPEC-*/spec.md'
+      - '{{SPEC_DIR}}/SPEC-*/spec.md'
     types: [opened, synchronize]
 
 permissions:
@@ -33,18 +33,18 @@ jobs:
           pwd
           ls -la
 
-          echo "=== Debug: Looking for .moai/specs ==="
-          ls -la .moai/ 2>&1 || echo ".moai/ directory not found"
+          echo "=== Debug: Looking for {{SPEC_DIR}} ==="
+          ls -la {{SPEC_DIR}}/ 2>&1 || echo "{{SPEC_DIR}}/ directory not found"
 
           # Find SPEC files in the PR
           echo "=== Debug: Searching for SPEC files ==="
           find . -name "spec.md" -type f 2>&1 || echo "find command failed"
 
-          spec_file=$(find .moai/specs -name "spec.md" -type f 2>&1 | head -1)
+          spec_file=$(find {{SPEC_DIR}} -name "spec.md" -type f 2>&1 | head -1)
           echo "Found spec_file: [$spec_file]"
 
           if [ -z "$spec_file" ]; then
-            echo "⚠️  No SPEC file found in .moai/specs"
+            echo "⚠️  No SPEC file found in {{SPEC_DIR}}"
             echo "Exiting gracefully (this is expected if no SPEC files changed)"
             exit 0
           fi
@@ -59,7 +59,11 @@ jobs:
           spec_priority=$(grep "^priority:" "$spec_file" | sed 's/^priority: *//' | tr -d ' "')
 
           # Extract title from H1 heading
+          {% if ENABLE_TAG_SYSTEM -%}
           spec_title=$(grep "^# @SPEC:" "$spec_file" | sed 's/^# @SPEC:[^:]*: //')
+          {% else -%}
+          spec_title=$(grep "^# " "$spec_file" | head -1 | sed 's/^# //')
+          {% endif -%}
 
           echo "✅ Extracted SPEC metadata:"
           echo "  ID: $spec_id"
@@ -158,7 +162,7 @@ jobs:
             echo "This SPEC has been synchronized to GitHub Issue."
             echo ""
             echo "📋 **Issue**: [#$issue_num - SPEC-$spec_id: $spec_title](../issues/$issue_num)"
-            echo "🔗 **SPEC File**: \`.moai/specs/SPEC-$spec_id/spec.md\`"
+            echo "🔗 **SPEC File**: \`{{SPEC_DIR}}/SPEC-$spec_id/spec.md\`"
             echo ""
             echo "The issue will be automatically updated as you modify the SPEC document."
           } > /tmp/pr_comment.txt