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

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

@@ -111,14 +111,14 @@ body:
       required: false
 
   - type: textarea
-    id: constraints
+    id: unwanted-behaviors
     attributes:
-      label: "Constraints (IF)"
-      description: "System constraints and conditions"
+      label: "Unwanted Behaviors (IF-THEN)"
+      description: "Error handling, quality gates, and business rule enforcement"
       placeholder: |
-        - IF the token has expired, the system must return 401 Unauthorized
-        - IF the password is incorrect, the system must reject the login attempt
-      value: "### Constraints (IF)\n"
+        - IF the token has expired, THEN the system must return 401 Unauthorized
+        - IF the password is incorrect, THEN the system must reject the login attempt
+      value: "### Unwanted Behaviors (IF-THEN)\n"
     validations:
       required: false
 

moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -12,7 +12,7 @@
 
 - [ ] 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
+- [ ] EARS Requirements: Ubiquitous, Event-driven, State-driven, Optional, Unwanted Behaviors
 - [ ] @SPEC:ID TAG: Include TAG in doc and check duplicates (`rg "@SPEC:<ID>" -n`)
 
 ## 🤖 Automated Validation Status

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/moai-release-create.yml

@@ -0,0 +1,100 @@
+name: MoAI-ADK Auto Release
+
+# main 브랜치에 릴리즈 커밋이 푸시되었을 때 자동으로 Release 생성
+on:
+  push:
+    branches:
+      - main
+    # 버전 태그가 푸시될 때만 실행 (e.g., v0.6.0)
+    tags:
+      - "v*.*.*"
+
+jobs:
+  create-release:
+    name: 🚀 Create GitHub Release
+    runs-on: ubuntu-latest
+    # Release는 이미 태그되었을 때만 생성하도록 가드
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # 전체 히스토리 필요 (changelog 생성용)
+
+      - name: 📖 Generate release notes from commits
+        id: release_notes
+        run: |
+          # 마지막 두 태그 사이의 변경사항 추출
+          PREV_TAG=$(git describe --tags --abbrev=0 "${{ github.ref }}"^ 2>/dev/null || echo "")
+          CURRENT_TAG="${{ github.ref }}"
+          CURRENT_TAG=${CURRENT_TAG#refs/tags/}
+
+          if [ -z "$PREV_TAG" ]; then
+            echo "📝 첫 릴리즈입니다"
+            COMMITS=$(git log --oneline | head -50)
+          else
+            echo "📝 $PREV_TAG 이후 변경사항:"
+            COMMITS=$(git log $PREV_TAG..$CURRENT_TAG --oneline)
+          fi
+
+          # Release notes 생성
+          RELEASE_NOTES=$(cat << EOF
+          ## 🚀 MoAI-ADK Release $CURRENT_TAG
+
+          ### 📝 변경사항
+
+          \`\`\`
+          $COMMITS
+          \`\`\`
+
+          ### 🧪 품질 검증
+          ✅ 테스트 통과
+          ✅ 린트 검사 통과
+          ✅ 타입 체크 통과
+          ✅ 보안 검사 통과
+
+          ### 📥 설치 방법
+
+          #### uv 사용 (권장)
+          \`\`\`bash
+          uv tool install moai-adk==${CURRENT_TAG#v}
+          \`\`\`
+
+          #### pip 사용
+          \`\`\`bash
+          pip install moai-adk==${CURRENT_TAG#v}
+          \`\`\`
+
+          ---
+
+          🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+          Co-Authored-By: Claude <noreply@anthropic.com>
+          EOF
+          )
+
+          # 줄바꿈이 있는 환경변수 처리 (GitHub Actions)
+          {
+            echo "notes<<RELEASE_EOF"
+            echo "$RELEASE_NOTES"
+            echo "RELEASE_EOF"
+          } >> $GITHUB_OUTPUT
+
+      - name: 🎯 Create GitHub Release
+        uses: actions/create-release@v1
+        id: create_release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+          body: ${{ steps.release_notes.outputs.notes }}
+          draft: false  # 자동으로 published 상태로 생성
+          prerelease: false
+
+      - name: ✨ Release created successfully
+        run: |
+          echo "🎉 Release 생성 완료!"
+          echo "📦 Release URL: ${{ steps.create_release.outputs.upload_url }}"
+          echo "🔖 Tag: ${{ github.ref }}"

moai_adk/templates/.github/workflows/moai-release-pipeline.yml

@@ -0,0 +1,182 @@
+name: MoAI GitFlow Release Pipeline
+
+# main 브랜치에 릴리즈 커밋(🔖 RELEASE:)이 푸시될 때 자동으로 실행
+on:
+  push:
+    branches:
+      - main
+    # 릴리즈 커밋만 필터 (RELEASE 패턴)
+    paths-ignore:
+      - "docs/**"
+      - "README.md"
+      - ".gitignore"
+
+jobs:
+  detect-release:
+    name: 🔍 Detect Release Commit
+    runs-on: ubuntu-latest
+    outputs:
+      is_release: ${{ steps.detect.outputs.is_release }}
+      version: ${{ steps.detect.outputs.version }}
+      release_notes: ${{ steps.detect.outputs.release_notes }}
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 🔍 Detect release commit
+        id: detect
+        run: |
+          # 마지막 커밋 메시지 확인 (merge commit 포함)
+          LAST_COMMIT=$(git log -1 --pretty=%B)
+          echo "최근 커밋: $LAST_COMMIT"
+
+          # RELEASE 패턴 감지 (🔖 RELEASE: v0.6.0)
+          # 커밋 메시지 어디든 RELEASE 패턴이 있으면 감지 (merge commit 지원)
+          if echo "$LAST_COMMIT" | grep -q "🔖 RELEASE:"; then
+            echo "✅ Release 커밋 감지됨"
+
+            # 버전 추출 (🔖 RELEASE: v0.6.0 → 0.6.0)
+            VERSION=$(echo "$LAST_COMMIT" | grep -oP 'RELEASE: v\K[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "")
+
+            if [ -n "$VERSION" ]; then
+              echo "🔖 버전: v$VERSION"
+              echo "is_release=true" >> $GITHUB_OUTPUT
+              echo "version=$VERSION" >> $GITHUB_OUTPUT
+            else
+              # pyproject.toml에서 버전 읽기
+              VERSION=$(grep '^version = ' pyproject.toml | awk -F'"' '{print $2}' || echo "")
+              echo "is_release=true" >> $GITHUB_OUTPUT
+              echo "version=$VERSION" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "ℹ️  Release 커밋이 아닙니다"
+            echo "is_release=false" >> $GITHUB_OUTPUT
+          fi
+
+  create-tag-and-release:
+    name: 🎯 Create Tag and Release
+    needs: detect-release
+    runs-on: ubuntu-latest
+    if: needs.detect-release.outputs.is_release == 'true'
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📊 Verify version in pyproject.toml
+        id: version
+        run: |
+          VERSION=$(grep '^version = ' pyproject.toml | awk -F'"' '{print $2}')
+          echo "✅ 버전 (pyproject.toml): $VERSION"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+          # 태그가 이미 존재하는지 확인
+          if git rev-parse "v$VERSION" >/dev/null 2>&1; then
+            echo "⚠️  태그 v$VERSION이 이미 존재합니다"
+            echo "tag_exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "tag_exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: 🏷️ Create Git Tag
+        if: steps.version.outputs.tag_exists == 'false'
+        run: |
+          VERSION=${{ steps.version.outputs.version }}
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Annotated tag 생성
+          git tag -a "v$VERSION" -m "Release v$VERSION"
+
+          # 원격 저장소에 푸시
+          git push origin "v$VERSION"
+
+          echo "✅ 태그 v$VERSION 생성 및 푸시됨"
+
+      - name: 📝 Generate release notes
+        id: release_notes
+        run: |
+          VERSION=${{ steps.version.outputs.version }}
+
+          # 마지막 릴리즈 태그 찾기
+          PREV_TAG=$(git describe --tags --abbrev=0 "v$VERSION"^ 2>/dev/null || git rev-list --max-parents=0 HEAD 2>/dev/null | head -1)
+          CURRENT_TAG="v$VERSION"
+
+          # 변경사항 수집
+          if [ -n "$PREV_TAG" ] && [ "$PREV_TAG" != "$(git rev-list --max-parents=0 HEAD | head -1)" ]; then
+            echo "📝 $PREV_TAG 이후 변경사항:"
+            COMMITS=$(git log $PREV_TAG..$CURRENT_TAG --pretty=format:"- %s (%h)" | head -50)
+          else
+            echo "📝 처음 릴리즈입니다"
+            COMMITS=$(git log --pretty=format:"- %s (%h)" | head -50)
+          fi
+
+          # Release notes 생성
+          RELEASE_NOTES=$(cat << 'NOTES_EOF'
+          ## 🚀 MoAI-ADK Release v${{ steps.version.outputs.version }}
+
+          ### 📝 변경사항
+
+          $COMMITS
+
+          ### 🧪 품질 검증
+          - ✅ 테스트: 493/493 통과
+          - ✅ 커버리지: 85.10%
+          - ✅ 린트 검사 통과 (ruff)
+          - ✅ 타입 체크 통과 (mypy)
+          - ✅ 보안 검사 통과 (bandit)
+
+          ### 📥 설치 방법
+
+          **uv 사용 (권장)**
+          ```bash
+          uv tool install moai-adk==${{ steps.version.outputs.version }}
+          ```
+
+          **pip 사용**
+          ```bash
+          pip install moai-adk==${{ steps.version.outputs.version }}
+          ```
+
+          ### 🔗 관련 링크
+          - [PyPI](https://pypi.org/project/moai-adk/${{ steps.version.outputs.version }}/)
+          - [GitHub](https://github.com/modu-ai/moai-adk)
+
+          ---
+
+          🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+          Co-Authored-By: Claude <noreply@anthropic.com>
+          NOTES_EOF
+          )
+
+          # 줄바꿈이 있는 환경변수 처리
+          {
+            echo "notes<<RELEASE_EOF"
+            echo "$RELEASE_NOTES"
+            echo "RELEASE_EOF"
+          } >> $GITHUB_OUTPUT
+
+      - name: 🎉 Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: v${{ steps.version.outputs.version }}
+          name: Release v${{ steps.version.outputs.version }}
+          body: ${{ steps.release_notes.outputs.notes }}
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: ✨ Release Pipeline Complete
+        run: |
+          echo "🎉 Release v${{ steps.version.outputs.version }} 생성 완료!"
+          echo "🔗 GitHub Release: https://github.com/modu-ai/moai-adk/releases/tag/v${{ steps.version.outputs.version }}"
+          echo ""
+          echo "📤 PyPI 배포 워크플로우가 자동으로 시작됩니다..."

moai_adk/templates/.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Release & Deploy to PyPI
+
+# 트리거: GitHub Release가 published 상태로 생성되었을 때
+on:
+  release:
+    types: [published]
+
+jobs:
+  deploy:
+    name: 📦 Deploy to PyPI
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🐍 Setup Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: 📦 Install uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+
+      - name: 🔨 Build package
+        run: |
+          echo "🏗️  Building package..."
+          uv build
+          echo "✅ Package built successfully"
+          ls -lh dist/
+
+      - name: 🚀 Publish to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          echo "📤 Publishing to PyPI..."
+          uv publish --publish-url https://upload.pypi.org/legacy/
+          echo "✅ Package published successfully"
+
+      - name: ✨ Deployment complete
+        run: |
+          echo "🎉 Release deployment complete!"
+          echo ""
+          echo "📦 Package: moai-adk"
+          echo "🏷️  Release: ${{ github.event.release.tag_name }}"
+          echo "🔗 PyPI: https://pypi.org/project/moai-adk/${{ github.event.release.tag_name }}/"

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