Initial commit

.SourceSageignore

@@ -0,0 +1,54 @@
+# バージョン管理システム関連
+.git/
+.gitignore
+
+# キャッシュファイル
+__pycache__/
+.pytest_cache/
+**/__pycache__/**
+*.pyc
+
+# ビルド・配布関連
+build/
+dist/
+*.egg-info/
+
+# 一時ファイル・出力
+output/
+output.md
+test_output/
+.SourceSageAssets/
+.SourceSageAssetsDemo/
+
+# アセット
+*.png
+*.svg
+*.jpg
+*.jepg
+assets/
+
+# その他
+LICENSE
+example/
+package-lock.json
+.DS_Store
+
+# 特定のディレクトリを除外
+tests/temp/
+docs/drafts/
+
+# パターンの例外（除外対象から除外）
+!docs/important.md
+!.github/workflows/
+repository_summary.md
+
+# Terraform関連
+.terraform
+*.terraform.lock.hcl
+*.backup
+*.tfstate
+
+# Python仮想環境
+venv
+.venv
+

.env.example

@@ -0,0 +1,12 @@
+### .env.example
+# 環境変数のサンプルファイル
+
+# OpenAI APIキー
+OPENAI_API_KEY=your_openai_api_key
+
+# GitHub APIトークン（省略可: GitHub Actionsでは自動で提供されます）
+GITHUB_TOKEN=your_github_token
+
+# Codex挙動の設定
+# 静粛モード: 1 に設定すると余分なログ出力を抑制
+CODEX_QUIET_MODE=1

.github/beta-workflows/beta-code-review-codex.yml

@@ -0,0 +1,81 @@
+name: Code Review Bot (Codex)
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  code-review:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0  # 完全な履歴を取得
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '20'
+      
+      - name: Install OpenAI Codex
+        run: |
+          npm install -g codex
+        
+      - name: Review PR with Codex
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          CODEX_QUIET_MODE: "1"
+        run: |
+          # PRの差分を取得
+          git fetch origin ${{ github.base_ref }}
+          git diff origin/${{ github.base_ref }}...${{ github.head_ref }} > pr_diff.txt
+          
+          # Codexを使ってコードレビュー
+          codex -a auto-edit "$(cat << 'EOF'
+          プルリクエストのコードレビューを実施してください。
+          
+          PR番号: #${{ github.event.pull_request.number }}
+          タイトル: ${{ github.event.pull_request.title }}
+          
+          以下の観点でレビューしてください：
+          
+          1. コード品質
+             - 命名規則が一貫しているか
+             - 未使用のコードやコメントアウトされたコードがないか
+             - コードの重複が最小限か
+          
+          2. セキュリティ
+             - APIキーやパスワードなどの機密情報が含まれていないか
+             - 適切なエラーハンドリングがされているか
+          
+          3. パフォーマンス
+             - 効率的なアルゴリズムが使用されているか
+             - 不要な処理がないか
+          
+          4. ドキュメント
+             - 適切なコメントが付けられているか
+             - READMEが更新されているか（必要な場合）
+          
+          レビュー結果は以下の形式で出力してください：
+          1. PRにコメントを投稿
+          2. 改善が必要な場合は、新しいブランチを作成して修正プルリクエストを作成
+          
+          重要: GitHubのトークンは環境変数 GITHUB_TOKEN で利用可能です。
+          差分は pr_diff.txt として保存されています。
+          EOF
+          )"
+      
+      - name: Post review comments
+        if: always()
+        run: |
+          if [ -f "review_comments.txt" ]; then
+            gh pr comment ${{ github.event.pull_request.number }} --body-file review_comments.txt
+          fi

.github/beta-workflows/beta-document-quality-check.yml

@@ -0,0 +1,179 @@
+name: Document Quality Check (Codex)
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - '**.md'
+  pull_request:
+    paths:
+      - '**.md'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  check-docs:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '20'
+      
+      - name: Install OpenAI Codex
+        run: |
+          npm install -g @openai/codex
+        
+      - name: Check documentation quality with Codex
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          CODEX_QUIET_MODE: "1"
+        run: |
+          # Codexを使ってドキュメントの品質をチェック
+          codex -a auto-edit  --quiet  "
+          リポジトリのドキュメントを品質チェックしてください。
+          
+          以下のチェックリストに従って確認し、必要に応じて修正してください：
+
+          ====
+          
+          # リポジトリ品質確認プロンプト V2
+          
+          あなたは優れたコードレビューとリポジトリ構造分析の専門家です。以下のチェックリストに沿って、リポジトリ全体の品質確認を行ってください。各項目について「✅」（問題なし）、「❌」（問題あり）、「⚠️」（一部問題あり）のいずれかで評価し、問題がある場合は具体的な改善提案を提示してください。
+          
+          ## チェックリスト
+          
+          ### 📝 README.md の品質確認
+          - [ ] タイトルは中央揃えになっているか
+          - [ ] ヘッダー画像は中央揃えになっているか(既にヘッダー画像がある場合はそれを使用すること)
+          - [ ] 技術スタックのバッジが適切に配置され、中央揃えになっているか
+          - [ ] 各セクションに絵文字が活用され、可読性が向上しているか
+          - [ ] ドキュメントは適切に分割されて、それぞれに適切にリンクされているか
+          - [ ] インストール手順が明確に記載されているか
+          - [ ] 使用方法が明確に記載されているか
+          - [ ] スクリーンショットや図が適切に使用されているか
+          
+          ### 📚 ドキュメンテーション全体の一貫性
+          - [ ] 各階層に README.md が存在するか（なければ作成が必要）
+          - [ ] 各階層の README.md が適切に上位階層の README.md を参照しているか
+          - [ ] 各 README.md の内容が重複せず、適切に分割されているか
+          - [ ] 各 README.md が重くなりすぎていないか、適切にファイル分割されているか
+          - [ ] 分割されたファイルに適切にリンクが貼られているか
+          - [ ] 全てのドキュメントで一貫した用語が使用されているか
+          - [ ] リポジトリ全体でのドキュメントの構造が論理的か
+          
+          ### 🔒 環境設定とセキュリティ
+          - [ ] `.env` や環境変数が適切に使用されているか
+          - [ ] 直接コード内にAPIキーやパスワードなどの機密情報が記載されていないか(`.env`にはOK)
+          - [ ] `.gitignore` ファイルに `.env` が適切に記載されているか
+          - [ ] `.env.example` が存在し、必要な環境変数の例が記載されているか
+          
+          ### 💻 コード品質
+          - [ ] コードコメントは適切に記載されているか
+          - [ ] 命名規則が一貫しているか
+          - [ ] 未使用のコードやコメントアウトされたコードが放置されていないか
+          
+          ### 📂 プロジェクト構造
+          - [ ] フォルダ構造が論理的で理解しやすいか
+          - [ ] 依存関係が適切に管理されているか
+          
+          ## 出力形式
+          
+          以下のような形式でチェックリストの結果を出力してください：
+          
+          ### 📝 README.md の品質確認
+          - [✅/❌/⚠️] タイトルは中央揃えになっているか
+            - 問題点と改善提案（問題がある場合）
+          - [✅/❌/⚠️] ヘッダー画像は中央揃えになっているか
+            - 問題点と改善提案（問題がある場合）
+          - ...（以下同様）
+          
+          ### 📚 ドキュメンテーション全体の一貫性
+          - [✅/❌/⚠️] 各階層に README.md が存在するか
+            - 問題点と改善提案（問題がある場合）
+          - [✅/❌/⚠️] 各階層の README.md が適切に上位階層の README.md を参照しているか
+            - 問題点と改善提案（問題がある場合）
+          - ...（以下同様）
+          
+          （他のセクションも同様の形式で）
+          
+          ### 🔍 総評
+          リポジトリの現在の状態に関する簡潔な総評と、優先して対応すべき最重要の改善点3つを提示してください。
+          
+          ### 📝 具体的な修正例
+          最も重要な改善点について、具体的なコードやマークダウンの修正例を提示してください。
+          
+          #### README.md 階層構造確認
+          以下の点を特に注意して確認してください：
+          1. 各ディレクトリに README.md があるか確認し、なければ作成を提案する
+          2. 各 README.md が上位の README.md を適切に参照しているか確認し、重複を避ける
+          3. README.md が長すぎる場合は、適切なファイル分割とリンク設定を提案する
+          
+          ---
+          
+          このチェックリストに沿って、リポジトリ全体を分析し、開発サイクルのクロージング処理として必要な改善点を明確にしてください。
+          
+          問題がある場合は自動的に修正し、新しいブランチを作成してプルリクエストを作成してください。
+          
+          重要: GitHubのトークンは環境変数 GITHUB_TOKEN で利用可能です。
+          "
+      
+      - name: Check if develop branch exists
+        id: check-develop
+        run: |
+          if git ls-remote --heads origin develop | grep develop; then
+            echo "develop_exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "develop_exists=false" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Create develop branch if it doesn't exist
+        if: ${{ steps.check-develop.outputs.develop_exists == 'false' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git checkout -b develop
+          git push origin develop
+          echo "Created new develop branch"
+      
+      - name: Commit changes to temporary branch
+        if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          
+          if [[ -n $(git status -s) ]]; then
+            TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+            BRANCH_NAME="docs/quality-improvement-${TIMESTAMP}"
+            git checkout -b $BRANCH_NAME
+            git add .
+            git commit -m "🫐 docs: ドキュメント品質の自動改善"
+            git push origin $BRANCH_NAME
+            echo "BRANCH_NAME=$BRANCH_NAME" >> $GITHUB_ENV
+          else
+            echo "No changes to commit"
+          fi
+      
+      - name: Create PR to develop
+        if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' && env.BRANCH_NAME != '' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Create PR to develop branch
+          gh pr create --title "🫐 docs: ドキュメント品質の自動改善" \
+                        --body "Codexによるドキュメント品質チェックを実行し、いくつかの改善を行いました。mainブランチからの変更をdevelopブランチにマージします。" \
+                        --base develop \
+                        --head $BRANCH_NAME

.github/beta-workflows/beta-readme-translation-codex.yml

@@ -0,0 +1,79 @@
+name: README Translation Bot (Codex)
+
+on:
+  push:
+    paths:
+      - 'README.md'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  translate-readme:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '20'
+      
+      - name: Install OpenAI Codex
+        run: |
+          npm install -g @openai/codex
+        
+      - name: Translate README with Codex
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          CODEX_QUIET_MODE: "1"
+        run: |
+          # READMEを英語に翻訳するためにCodexを使用
+          codex -a auto-edit  --quiet "
+          README.mdを英語に翻訳してください。
+          
+          以下の要件に従って翻訳してください：
+          
+          1. 元のマークダウン形式を維持
+          2. 技術用語は適切な英語で表現
+          3. 絵文字はそのまま維持
+          4. バッジやリンクは変更しない
+          5. コードブロックの内容は翻訳しない
+          
+          翻訳後のファイルは README.en.md として保存してください。
+          その後、以下の作業を行ってください：
+          
+          1. 新しいブランチを作成
+          2. README.en.md をコミット
+          3. プルリクエストを作成
+          4. PRの説明文に翻訳の品質に関する簡単なサマリーを記載
+          
+          重要: GitHubのトークンは環境変数 GITHUB_TOKEN で利用可能です。
+          "
+      
+      - name: Create PR if translation is created
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          CODEX_QUIET_MODE: "1"
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          
+          if [ -f "README.en.md" ]; then
+            BRANCH_NAME="docs/translate-readme-en-$(date +%Y%m%d-%H%M%S)"
+            git checkout -b $BRANCH_NAME
+            git add README.en.md
+            git commit -m "docs: READMEを英語に翻訳"
+            git push origin $BRANCH_NAME
+            
+            gh pr create --title "📄 docs: READMEを英語に翻訳" \
+                         --body "CodexによってREADMEを英語に翻訳しました。" \
+                         --base develop \
+                         --head $BRANCH_NAME
+          fi

.github/workflows/auto-release-notes.yml

@@ -0,0 +1,131 @@
+name: Auto Release Notes with Codex
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  create-release-notes:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Install OpenAI Codex
+        run: npm install -g @openai/codex
+        
+      - name: Generate Diff File
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # 現在のタグと前のタグを取得
+          CURRENT_TAG=${GITHUB_REF#refs/tags/}
+          PREVIOUS_TAG=$(git describe --tags --abbrev=0 ${CURRENT_TAG}^ 2>/dev/null || echo "")
+          
+          # タグ間の差分を生成してファイルに保存
+          if [ -n "$PREVIOUS_TAG" ]; then
+            echo "タグ間の差分を生成中: ${PREVIOUS_TAG}..${CURRENT_TAG}"
+            git diff ${PREVIOUS_TAG}..${CURRENT_TAG} > diff.txt
+            echo "コミットログを生成中: ${PREVIOUS_TAG}..${CURRENT_TAG}"
+            git log ${PREVIOUS_TAG}..${CURRENT_TAG} --pretty=format:"%h - %s%n%b%n" > commits.txt
+          else
+            echo "初回リリース: すべての変更を含めます"
+            git diff $(git rev-list --max-parents=0 HEAD)..HEAD > diff.txt
+            git log --pretty=format:"%h - %s%n%b%n" > commits.txt
+          fi
+          
+          # 変更されたファイルのリストを生成
+          if [ -n "$PREVIOUS_TAG" ]; then
+            git diff --name-status ${PREVIOUS_TAG}..${CURRENT_TAG} > changed_files.txt
+          else
+            git diff --name-status $(git rev-list --max-parents=0 HEAD)..HEAD > changed_files.txt
+          fi
+      
+      - name: Generate Release Notes
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          CODEX_QUIET_MODE: "1"
+          CODEX_NO_TTY: "1"
+        run: |
+          # 現在のタグと前のタグを取得
+          CURRENT_TAG=${GITHUB_REF#refs/tags/}
+          PREVIOUS_TAG=$(git describe --tags --abbrev=0 ${CURRENT_TAG}^ 2>/dev/null || echo "")
+          
+          # Codexにリリースノートの生成を指示
+          codex -a auto-edit --quiet "以下の情報を使ってリリースノートを作成し、release_notes.mdファイルに保存してください：
+          
+          現在のタグ: ${CURRENT_TAG}
+          前回のタグ: ${PREVIOUS_TAG}
+          
+          実行してください：
+          1. 以下のファイルを読み込んで分析してください:
+             - diff.txt: 2つのタグ間のコード差分
+             - commits.txt: コミットログ
+             - changed_files.txt: 変更されたファイルのリスト
+          
+          2. これらのファイルを分析して、以下を含むリリースノートを作成：
+             - 新機能
+             - バグ修正
+             - 破壊的変更
+             - その他の改善
+          
+          3. リリースノートをrelease_notes.mdファイルに保存
+          
+          リリースノートは以下の形式でフォーマットしてください：
+          # Release ${CURRENT_TAG}: [リリースノートのタイトルをここに記入]
+          
+          ## 🚀 新機能
+          - 機能の説明
+          
+          ## 🐛 バグ修正
+          - 修正内容の説明
+          
+          ## ⚠️ 破壊的変更
+          - 変更内容の説明
+          
+          前回のタグが存在しない場合は、初回リリースとして適切なメッセージを作成してください。
+      
+          ファイルの作成は以下のように実行してください：
+          echo '# Release ${CURRENT_TAG}' > release_notes.md
+          echo '' >> release_notes.md
+          # ... (他の内容) ...
+          "
+          
+          # デバッグ用にリリースノートの内容を表示
+          if [ -f release_notes.md ]; then
+            echo "生成されたリリースノート:"
+            cat release_notes.md
+          else
+            echo "リリースノートの生成に失敗しました"
+          fi
+      
+      - name: Create Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          CURRENT_TAG=${GITHUB_REF#refs/tags/}
+          # release_notes.mdが存在する場合はそれを使用
+          if [ -f release_notes.md ]; then
+            gh release create ${CURRENT_TAG} --title "🚀 Release ${CURRENT_TAG}" --notes-file release_notes.md
+          else
+            # Codexが失敗した場合のフォールバック
+            echo "# Release ${CURRENT_TAG}" > fallback_notes.md
+            echo "" >> fallback_notes.md
+            PREVIOUS_TAG=$(git describe --tags --abbrev=0 ${CURRENT_TAG}^ 2>/dev/null || echo "")
+            if [ -n "$PREVIOUS_TAG" ]; then
+              echo "## コミット一覧" >> fallback_notes.md
+              git log ${PREVIOUS_TAG}..${CURRENT_TAG} --pretty=format:"- %s" >> fallback_notes.md
+            else
+              echo "## 初回リリース" >> fallback_notes.md
+              echo "このリポジトリの初回リリースです。" >> fallback_notes.md
+            fi
+            gh release create ${CURRENT_TAG} --title "🌟 Release ${CURRENT_TAG}" --notes-file fallback_notes.md
+          fi

.github/workflows/debug-info-codex.yml

@@ -0,0 +1,142 @@
+name: Debug Information
+
+on:
+  workflow_dispatch:  # 手動実行
+    inputs:
+      issue_number:
+        description: 'Issue番号'
+        required: true
+        type: string
+  issues:  # issueが開いたときに自動実行
+    types: [opened]
+  workflow_call:  # 他のワークフローから呼び出し可能
+    inputs:
+      issue_number:
+        required: true
+        type: string
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  debug-info:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Set Issue Number
+        id: issue
+        run: |
+          # issue_numberを設定：手動実行、issue開封、または他のワークフローからの呼び出し
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "issue_number=${{ github.event.inputs.issue_number }}" >> $GITHUB_OUTPUT
+          elif [ "${{ github.event_name }}" = "issues" ]; then
+            echo "issue_number=${{ github.event.issue.number }}" >> $GITHUB_OUTPUT
+          else
+            echo "issue_number=${{ inputs.issue_number }}" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      
+      - name: Install OpenAI Codex
+        run: npm install -g @openai/[email protected]
+        
+      - name: GitHub CLIをインストール
+        run: |
+          type -p curl >/dev/null || apt install curl -y
+          curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+          && sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
+          && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+          && sudo apt update \
+          && sudo apt install gh -y
+
+      - name: Debug Information
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ISSUE_NUMBER: ${{ steps.issue.outputs.issue_number }}
+        run: |
+          # コマンドを実行して結果を取得
+          echo "Codexの詳細情報を取得中..."
+          
+          # 情報収集
+          SYSTEM_INFO=$(uname -a)
+          OS_INFO=$(cat /etc/os-release 2>/dev/null || lsb_release -a 2>/dev/null)
+          NODE_VERSION=$(node -v)
+          NPM_VERSION=$(npm -v)
+          CODEX_VERSION=$(codex --version 2>/dev/null || echo 'バージョン取得失敗')
+          CODEX_PATH=$(which codex 2>/dev/null || echo '場所不明')
+          CODEX_PACKAGE_INFO=$(npm list -g @openai/codex 2>/dev/null || echo '情報取得失敗')
+          NPM_VERSIONS=$(npm view @openai/codex versions --json 2>/dev/null || echo '[]')
+          
+          # cgroup確認
+          if [ -f /proc/1/cgroup ]; then
+            CGROUP_EXISTS="✅ 存在します"
+            CGROUP_CONTENT=$(head -n 5 /proc/1/cgroup)
+          else
+            CGROUP_EXISTS="❌ 存在しません"
+            CGROUP_CONTENT=""
+          fi
+          
+          # codexコマンドのヘルプ情報
+          CODEX_HELP=$(codex --help 2>&1 | head -n 20)
+          
+          # 結果をファイルに保存
+          echo "環境情報をissueにコメントします"
+          {
+            echo "## 🔍 デバッグ情報"
+            echo "<details>"
+            echo "<summary>詳細情報（クリックして展開）</summary>"
+            echo ""
+            echo "サンドボックスエラー「Sandbox was mandated, but no sandbox is available!」のデバッグ情報："
+            echo ""
+            echo "### システム環境"
+            echo "\`\`\`"
+            echo "$SYSTEM_INFO"
+            echo "$OS_INFO"
+            echo "\`\`\`"
+            echo ""
+            echo "### Node.js & npm 情報"
+            echo "\`\`\`"
+            echo "Node.js: $NODE_VERSION"
+            echo "npm: $NPM_VERSION"
+            echo "\`\`\`"
+            echo ""
+            echo "### Codex情報"
+            echo "\`\`\`"
+            echo "Version: $CODEX_VERSION"
+            echo "Path: $CODEX_PATH"
+            echo "Package info: "
+            echo "$CODEX_PACKAGE_INFO"
+            echo "\`\`\`"
+            echo ""
+            echo "### 利用可能なCodexバージョン"
+            echo "\`\`\`"
+            echo "$NPM_VERSIONS" | jq -r 'if type=="array" then .[-5:] else . end' 2>/dev/null || echo "$NPM_VERSIONS"
+            echo "\`\`\`"
+            echo ""
+            echo "### サンドボックス関連"
+            echo "/proc/1/cgroup ファイル: $CGROUP_EXISTS"
+            if [ -n "$CGROUP_CONTENT" ]; then
+              echo "\`\`\`"
+              echo "$CGROUP_CONTENT"
+              echo "\`\`\`"
+            fi
+            echo ""
+            echo "### Codexヘルプ情報"
+            echo "\`\`\`"
+            echo "$CODEX_HELP"
+            echo "\`\`\`"
+            echo ""
+            echo "### 対応策"
+            echo "1. \`--approval=auto\` または \`--approval=manual\` オプションを試す"
+            echo "2. 最新バージョンに更新: \`npm install -g @openai/codex@latest\`"
+            echo "3. 環境変数の設定: \`FORCE_DISABLE_SANDBOX=true codex ...\`"
+            echo "</details>"
+          } > debug_info.txt
+          
+          # ファイル内容を表示（ログ用）
+          cat debug_info.txt
+          
+          # Issueにコメント
+          gh issue comment $ISSUE_NUMBER --body-file debug_info.txt

.github/workflows/issue-auto-labeling.yml

@@ -0,0 +1,65 @@
+name: Auto Label Issues
+
+on:
+  issues:
+    types: [opened]
+
+permissions:
+  issues: write
+
+jobs:
+  auto-label:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      
+      - name: Install OpenAI Codex
+        run: npm install -g @openai/[email protected]
+        
+      - name: GitHub CLIをインストール
+        run: |
+          type -p curl >/dev/null || apt install curl -y
+          curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+          && sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
+          && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+          && sudo apt update \
+          && sudo apt install gh -y
+          
+      - name: Auto-label Issue
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          # プロンプトを一時ファイルに保存
+          cat > prompt.txt << 'EOF'
+          このIssueを分析して、最も適切なラベルを選んで、ghコマンドでラベルを付けてください：
+          
+          Issue番号: #${{ github.event.issue.number }}
+          タイトル: ${{ github.event.issue.title }}
+          内容:
+          ---
+          ${{ github.event.issue.body }}
+          ---
+          
+          1. まず現在のラベル一覧を確認：
+          gh label list
+          
+          2. 必要なラベルがない場合は作成（例：bugラベルがない場合）：
+          gh label create bug --color 'ee0701' --description 'バグに関するissue'
+          gh label create documentation --color '0052cc' --description 'ドキュメントに関するissue'
+          gh label create enhancement --color '0e8a16' --description '機能改善・追加の提案'
+          gh label create 'help wanted' --color '5319e7' --description 'サポートが必要なissue'
+          gh label create question --color 'd876e3' --description '質問に関するissue'
+          
+          3. issueの内容を分析して適切なラベルを選択：
+          gh issue edit ${{ github.event.issue.number }} --add-label '適切なラベル'
+          （内容に応じて適切なラベルを選んでください）
+          
+          4. 最後に現在のラベル一覧を表示：
+          gh label list
+          EOF
+          
+          # Codexに処理させる
+          codex --full-auto --quiet --model o3 "$(cat prompt.txt)"

.github/workflows/issue-response-codex.yml

@@ -0,0 +1,178 @@
+name: Issue Response Bot (Codex with gh)
+
+on:
+  issues:
+    types: [opened, edited]
+  issue_comment:
+    types: [created]
+
+permissions:
+  issues: write
+  contents: write
+  pull-requests: write
+
+jobs:
+
+  respond-to-issue:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      
+      - name: Install OpenAI Codex
+        run: npm install -g @openai/[email protected]
+        
+      - name: GitHub CLIをインストール
+        run: |
+          type -p curl >/dev/null || apt install curl -y
+          curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+          && sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
+          && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+          && sudo apt update \
+          && sudo apt install gh -y
+          
+      - name: Post Initial Comment
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh issue comment ${{ github.event.issue.number }} --body '🚀 処理を開始します...
+
+          <details>
+          <summary>Codexへの指示内容</summary>
+
+          ```
+          以下のissueに対する対応計画を立て、ghコマンドでコメントしてください：
+          
+          Issue番号: #${{ github.event.issue.number }}
+          タイトル: ${{ github.event.issue.title }}
+          内容: ${{ github.event.issue.body }}
+          
+          実行してください：
+          1. issueを分析して対応方針を決定
+          2. ghコマンドで計画をissueにコメント (例: gh issue comment #番号 --body '"'"'内容'"'"')
+          3. 必要なコード修正やドキュメント更新を実施
+          ```
+          </details>'
+          
+      - name: Analyze and Plan
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          # プロンプトを一時ファイルに保存
+          cat > prompt.txt << 'EOF'
+          以下のissueに対する対応計画を立て、ghコマンドでコメントしてください：
+          
+          Issue番号: #${{ github.event.issue.number }}
+          タイトル: ${{ github.event.issue.title }}
+          本文: ${{ github.event.issue.body }}
+          
+          実行してください：
+          1. issueを分析して対応方針やTODOを決定
+          2. ghコマンドで計画・TODOをissueにコメント (必ず --body-file を使用)
+          3. 必要なコード修正やドキュメント更新を実施
+          
+          重要：複雑な文字列を扱う際は、エスケープ問題を避けるために一時ファイルを使用してください。
+          例えば、gh issue comment や gh pr create コマンドでは --body よりも --body-file を使用してください。
+          
+          以下のような方法で実装してください：
+          1. 本文内容をファイルに書き出す: echo '内容' > comment.txt
+          2. ファイルを参照: gh issue comment 番号 --body-file comment.txt
+          
+          特に改行を含む複雑な文字列を扱う場合は必ずこの方法を使用してください。
+          インラインでの複雑なエスケープ ($\' や \" の組み合わせ) は避けてください。
+          EOF
+          
+          # Codexに処理させる
+          codex --full-auto --quiet --model o3 "$(cat prompt.txt)"
+          
+      - name: Create PR
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          # タイムスタンプを生成 (YYYYMMDDHHmmss形式)
+          TIMESTAMP=$(date '+%Y%m%d%H%M%S')
+          BRANCH_NAME="fix-issue-${{ github.event.issue.number }}-$TIMESTAMP"
+          
+          # PRプロンプトを一時ファイルに保存
+          cat > pr_prompt.txt << 'EOF'
+          あなたはサンドボックス環境で動作しており、全権限を与えられています！
+          ⚠️ 重要：以下の全ステップを必ず最後まで実行してください！途中で止めずに、リモートへのプッシュとPR作成まで必ず完了させてください。
+      
+          🔴 特に重要：
+          - `git push` コマンドは必ず実行する
+          - `gh pr create` コマンドは必ず実行する  
+          - PRを作成したら、そのURLを確認して、Issueにコメントする
+      
+          以下の手順を必ず全て実行してください：
+      
+          1. Gitの設定を確認して、必要に応じて設定する
+          git config user.email "[email protected]"
+          git config user.name "Codex CLI"
+          
+          2. ブランチの作成と変更のコミット
+          git checkout -b $BRANCH_NAME
+          git add -A
+          
+          # コミットメッセージを作成
+          git commit -m "🔧 fix: #${{ github.event.issue.number }} ${{ github.event.issue.title }}" \
+            -m "🔍 問題: ${{ github.event.issue.body }}" \
+            -m "✅ 対応: 必要なファイルを追加・修正しました" \
+            -m "Issue: #${{ github.event.issue.number }}"
+          
+          3. ❗必ずリモートにプッシュする（スキップ不可）
+          git push -u origin $BRANCH_NAME
+          
+          # プッシュの完了を確認
+          echo "✅ プッシュ完了"
+          
+          4. PRの本文を作成（一時ファイルを使用）
+          echo "## 🚀 対応内容
+          ${{ github.event.issue.body }}
+          
+          ### 🔍 問題と解決策
+          Issueの内容に基づいて適切な対応を実施しました。
+          
+          ### 📝 変更内容
+          変更内容を確認してください。
+          
+          ### 🧪 テスト内容
+          動作確認を行い、問題なく動作することを確認しました。
+          
+          Fixes #${{ github.event.issue.number }}" > pr_body.txt
+          
+          5. ❗必ずプルリクエストを作成する（スキップ不可）
+          gh pr create \
+            --title "✨ fix: #${{ github.event.issue.number }} ${{ github.event.issue.title }}" \
+            --body-file pr_body.txt \
+            --base main \
+            --head $BRANCH_NAME
+          
+          # PRが作成されたことを確認
+          PR_URL=$(gh pr view --json url -q .url)
+          echo "✅ PRを作成しました: $PR_URL"
+          
+          6. Issueにコメントする
+          echo "🎉 PR作成完了しました！
+          
+          👀 レビューをお願いします
+          🔗 PR: $PR_URL
+          
+          ### 📋 対応概要
+          ${{ github.event.issue.title }}に対応するPRを作成しました。レビューよろしくお願いします！" > comment.txt
+          
+          gh issue comment ${{ github.event.issue.number }} --body-file comment.txt
+          
+          # 重要：全プロセスを完了したことを確認
+          echo "✅ 全てのステップが正常に完了しました："
+          echo "  - ブランチ作成: ✓"
+          echo "  - コミット: ✓"
+          echo "  - プッシュ: ✓"
+          echo "  - PR作成: ✓"
+          echo "  - Issueコメント: ✓"
+          EOF
+          
+          # Codexに処理させる
+          codex --full-auto --quiet --model o3 "$(cat pr_prompt.txt)"

.github/workflows/sync-to-hf.yml

@@ -0,0 +1,22 @@
+name: Sync to Hugging Face hub
+on:
+  push:
+    branches: [main]
+
+  # to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          lfs: true
+      - name: Push to hub
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: |
+          git fetch https://MakiAi:[email protected]/spaces/MakiAi/gradio-mcp-template main || true
+          git push --force https://MakiAi:[email protected]/spaces/MakiAi/gradio-mcp-template main

.gitignore

@@ -0,0 +1,7 @@
+# Ignore text files in repository root
+/*.txt
+.SourceSageAssets/
+*.json
+*.log
+
+!requirements.txt

README.md

@@ -0,0 +1,138 @@
+---
+title: Gradio MCP Minimal
+emoji: 🌍
+colorFrom: blue
+colorTo: blue
+sdk: gradio
+sdk_version: 5.26.0
+app_file: app.py
+pinned: false
+---
+
+<div align="center">
+
+![Image](https://github.com/user-attachments/assets/89233e89-d2e4-4e29-b1b8-fc5c90a7e4b2)
+
+
+# 🚀 **Gradio MCP Minimal**
+
+<p align="center">
+  <a href="https://www.python.org">
+    <img alt="Python" src="https://img.shields.io/badge/Python-3.12-blue?logo=python&logoColor=white">
+  </a>
+  <a href="https://www.gradio.app">
+    <img alt="Gradio" src="https://img.shields.io/badge/Gradio-5.26.0-orange?logo=gradio">
+  </a>
+  <a href="https://github.com/makiai/gradio-mcp-minimal/blob/main/LICENSE">
+    <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-green">
+  </a>
+  <a href="https://github.com/makiai/gradio-mcp-minimal/stargazers">
+    <img alt="GitHub Stars" src="https://img.shields.io/github/stars/makiai/gradio-mcp-minimal?style=social">
+  </a>
+<a href="https://huggingface.co/spaces/MakiAi/gradio-mcp-minimal">
+    <img alt="HF Spaces" src="https://img.shields.io/badge/Spaces-Live%20Demo-blueviolet?logo=huggingface&logoColor=white">
+  </a>
+</p>
+</div>
+
+## ✨ 概要
+このリポジトリは **最小構成** で Gradio アプリを立ち上げ、同時に **MCP (Model Context Protocol) サーバー** として機能させるサンプルです。  
+たった 1 つのファイルを実行するだけで、Web UI と MCP SSE エンドポイントの両方が手に入ります。
+
+## 📄 ファイル構成
+| ファイル / ディレクトリ | 役割 |
+|------------------------|------|
+| `app.py`               | Gradio UI + MCP サーバー（`letter_counter` ツール） |
+| `requirements.txt`     | 依存パッケージ（`gradio[mcp]` のみ） |
+| `assets/header.svg`    | README 用ヘッダー画像（任意） |
+
+## 📦 セットアップ
+
+### 🚀 uv を使ったクイックスタート（推奨）
+
+```bash
+# 仮想環境の作成
+uv venv
+# 仮想環境の有効化
+source .venv/bin/activate
+# 依存インストール
+uv pip install -r requirements.txt
+```
+
+### 🐍 標準 pip のみで実行したい場合
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+## 🚀 実行
+以下のコマンドを実行でローカルサーバーが起動します。
+```bash
+python app.py
+```
+
+- Web UI: <http://127.0.0.1:7860>  
+- MCP SSE エンドポイント: <http://127.0.0.1:7860/gradio_api/mcp/sse>  
+  - UI フッター → **View API** → **MCP** をクリックすると、コピペ可能な設定 JSON が表示されます。
+
+## ⚙️ MCP クライアント設定例
+Claude Desktop / Cline などで `claude_desktop_config.json` 等に追記:
+```jsonc
+{
+  "mcpServers": {
+    "gradio-local": {
+      "url": "http://127.0.0.1:7860/gradio_api/mcp/sse"
+    }
+  }
+}
+```
+クライアントを再起動すると `letter_counter` ツールが利用できるようになります 🎉
+
+## 🔧 仕組み
+```python
+demo.launch(mcp_server=True)
+```
+この 1 行で Gradio アプリが SSE ベースの MCP サーバーとして動作します。  
+ドキュストリングと型ヒントから自動でスキーマが生成されます。
+
+## 🌠 拡張方法
+1. `app.py` に関数を追加し、適切なドキュストリングを記述  
+2. `Interface(...)` へ登録（または Blocks を使用）  
+3. 再起動すれば新しい MCP ツールとして自動公開
+
+## 🛫 🤗 Spaces へ無料デプロイ
+ファイル一式を Hugging Face Spaces (Gradio テンプレート) へプッシュすると、無料の公開 MCP サーバーになります:
+```
+https://<your-space>.hf.space/gradio_api/mcp/sse
+```
+例）`https://makiai-gradio-mcp-minimal.hf.space/gradio_api/mcp/sse`
+
+## 🔗 MCP クライアント設定例 (Spaces)
+
+Spaces で公開したサーバーを **MCP クライアント（Claude Desktop / Cline など）** から呼び出す手順です。
+
+1. **エンドポイント URL**
+   ```
+   https://<your-space>.hf.space/gradio_api/mcp/sse
+   ```
+   例）`https://makiai-gradio-mcp-minimal.hf.space/gradio_api/mcp/sse`
+
+2. **config 追記例** (`claude_desktop_config.json` 等)
+   ```jsonc
+   {
+     "mcpServers": {
+       "gradio-space": {                // 任意の名前
+         "url": "https://makiai-gradio-mcp-minimal.hf.space/gradio_api/mcp/sse"
+       }
+     }
+   }
+   ```
+
+3. **動作確認**
+   クライアントを再起動 → Tool Palette で `server = gradio-space` を選択 →
+   `letter_counter` ツールに `text: "hello"` を送信し、`length: 5` が返れば接続完了です 🎉
+
+## 📝 ライセンス
+MIT

app.py

@@ -0,0 +1,107 @@
+import numpy as np
+import gradio as gr
+import qrcode
+from PIL import Image
+import io  # Added for parity with user-provided snippet (currently unused)
+
+
+def reverse_text(text):
+    """
+    テキストを反転する。
+
+    Args:
+        text (str): 反転したいテキスト。
+
+    Returns:
+        str: 反転されたテキスト。
+    """
+    return text[::-1]
+
+
+def generate_qr_code(text):
+    """
+    テキストからQRコードを生成する。
+
+    Args:
+        text (str): QRコードに埋め込むテキスト。
+
+    Returns:
+        numpy.ndarray: 生成されたQRコード画像 (RGB)。
+    """
+    qr = qrcode.QRCode(version=5, box_size=10, border=5)
+    qr.add_data(text)
+    qr.make(fit=True)
+    img = qr.make_image(fill_color="black", back_color="white")
+
+    # PILイメージをNumPy配列に変換
+    img_array = np.array(img.convert("RGB"))
+    return img_array
+
+
+def count_words(text):
+    """
+    テキストの単語数をカウントする。
+
+    Args:
+        text (str): カウントしたいテキスト。
+
+    Returns:
+        int: 単語数。
+    """
+    if not text.strip():
+        return 0
+    return len(text.split())
+
+
+def resize_image(image, width, height):
+    """
+    画像をリサイズする。
+
+    Args:
+        image (numpy.ndarray): リサイズしたい画像。
+        width (int): 新しい幅。
+        height (int): 新しい高さ。
+
+    Returns:
+        numpy.ndarray: リサイズされた画像 (RGB)。
+    """
+    # NumPy配列からPILイメージに変換
+    pil_image = Image.fromarray(image)
+
+    resized_image = pil_image.resize((int(width), int(height)))
+    return np.array(resized_image)
+
+
+# --- Interface -----------------------------------------------------------
+
+resize_interface = gr.Interface(
+    fn=resize_image,
+    inputs=[
+        gr.Image(),
+        gr.Number(label="幅", value=300),
+        gr.Number(label="高さ", value=300),
+    ],
+    outputs=gr.Image(),
+    api_name="resize_image",
+)
+
+
+demo = gr.TabbedInterface(
+    [
+        gr.Interface(reverse_text, gr.Textbox(), gr.Textbox(), api_name="reverse_text"),
+        gr.Interface(generate_qr_code, gr.Textbox(), gr.Image(), api_name="generate_qr_code"),
+        gr.Interface(count_words, gr.Textbox(), gr.Number(), api_name="count_words"),
+        resize_interface,
+    ],
+    [
+        "テキスト反転",
+        "QRコード生成",
+        "単語数カウント",
+        "画像リサイズ",
+    ],
+)
+
+
+if __name__ == "__main__":
+    # mcp_server=True starts the SSE endpoint at /gradio_api/mcp/sse
+    demo.launch(mcp_server=True)

requirements.txt

@@ -0,0 +1,6 @@
+gradio
+numpy
+qrcode[pil]
+pillow
+mcp
+https://gradio-pypi-previews.s3.amazonaws.com/3b5cace94781b90993b596a83fb39fd1584d68ee/gradio-5.26.0-py3-none-any.whl