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

moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,25 +1,20 @@
-# {{PROJECT_NAME}} GitFlow PR
+# MoAI-ADK 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: `{{SPEC_DIR}}/SPEC-AUTH-001/`
-{% if ENABLE_TAG_SYSTEM -%}
+- Directory: `.moai/specs/SPEC-AUTH-001/`
 - @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 -%}
+- [ ] EARS Requirements: Ubiquitous, Event-driven, State-driven, Optional, Unwanted Behaviors
 - [ ] @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 -->
@@ -30,29 +25,24 @@
 - [ ] 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: {{CONVERSATION_LANGUAGE}}
+- Project Language: <!-- ko/en/ja/zh -->
 - Commit Messages: <!-- generated automatically according to locale -->
 
 ## 🎯 Changes
 
-<!-- auto-fills TDD results -->
+<!-- code-builder auto-fills TDD results -->
 
 ### 🔴 RED (Test Authoring)
-- Test File: `{{TEST_DIR}}/auth/service.test.ts`
+- Test File: `tests/auth/service.test.ts`
 - Test Description: [describe the failing test]
 
 ### 🟢 GREEN (Implementation)
@@ -68,14 +58,12 @@
 
 - [ ] Update README
 - [ ] Sync API docs
-{% if ENABLE_TAG_SYSTEM -%}
 - [ ] Update TAG index
-{% endif -%}
 - [ ] Update HISTORY section (SPEC docs)
 
 ---
 
-🚀 {{PROJECT_NAME}}: Professional development via a 3-stage pipeline!
+🚀 MoAI-ADK: Professional development without Git commands via a 3-stage pipeline!
 
-Reviewers: Check quality compliance and SPEC metadata completeness only.
+Reviewers: Check TRUST 5 compliance and SPEC metadata completeness only.
 

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 }}/"