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/issue-response-codex.yml

@@ -0,0 +1,248 @@
+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/codex@0.1.2504251709
+        
+      - 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: Debug Information
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        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 ${{ github.event.issue.number }} --body-file debug_info.txt
+      
+          
+      - name: Analyze and Plan
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          # Codexに計画を立てさせ、issueにコメントさせる
+          codex --full-auto  --quiet  "以下の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. 必要なコード修正やドキュメント更新を実施
+          
+          # 重要：複雑な文字列を扱う際は、エスケープ問題を避けるために一時ファイルを使用してください。
+          # 例えば、gh issue comment や gh pr create コマンドでは --body よりも --body-file を使用してください。
+          # 
+          # 以下のような方法で実装してください：
+          # 1. 本文内容をファイルに書き出す: echo '内容' > comment.txt
+          # 2. ファイルを参照: gh issue comment 番号 --body-file comment.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"
+          
+          # 現在の状態を確認
+          git status
+          
+          # 新しいブランチを作成
+          git checkout -b $BRANCH_NAME
+          
+          # ブランチ切り替え後の状態を確認
+          git status
+          
+          # Codexが作成したファイル変更を全て追加
+          git add .
+          
+          # ステージング後の状態を確認
+          git status
+          
+          # Codexにプルリクエストを作成させる
+          codex --full-auto --quiet $'以下の手順でプルリクエストを作成してください：
+      
+          # 変更されたファイルをチェック
+          git status
+      
+          # 適切なコミットメッセージで変更をコミット
+          # Issue番号とタイトルを参照し、変更の種類に応じて内容を調整してください
+          git commit -m "🔧 fix: #${{ github.event.issue.number }} ${{ github.event.issue.title }}" -m "🔍 問題: ${{ github.event.issue.body }}" -m "✅ 対応: 必要なファイルを追加・修正しました" -m "Issue: #${{ github.event.issue.number }}"
+          
+          # ブランチをリモートにプッシュ
+          git push origin HEAD:$BRANCH_NAME
+          
+          # 重要：PRやIssueコメントの作成時は、複雑な文字列処理を避けるために一時ファイルを使用してください
+          # PRの本文を一時ファイルに書き出す
+          echo "## 🚀 対応内容
+          ${{ github.event.issue.body }}
+          
+          ### 🔍 問題と解決策
+          Issueの内容に基づいて適切な対応を実施しました。
+          
+          ### 📝 変更内容
+          - 変更したファイルとその内容の説明
+          
+          ### 🧪 テスト内容
+          - 動作確認方法と結果
+          
+          Fixes #${{ github.event.issue.number }}" > pr_body.txt
+          
+          # PRを作成 - 一時ファイルを参照
+          gh pr create \
+            --title "✨ fix: #${{ github.event.issue.number }} ${{ github.event.issue.title }}" \
+            --body-file pr_body.txt \
+            --base main \
+            --head $BRANCH_NAME
+          
+          # PRのURLを取得
+          PR_URL=$(gh pr view --json url -q .url)
+          
+          # Issueコメントの内容を一時ファイルに書き出す
+          echo "🎉 PR作成完了しました！
+          
+          👀 レビューをお願いします
+          🔗 PR: $PR_URL
+          
+          ### 📋 対応概要
+          ${{ github.event.issue.title }}に対応するPRを作成しました。レビューよろしくお願いします！" > comment.txt
+          
+          # Issueにコメント - 一時ファイルを参照
+          gh issue comment ${{ github.event.issue.number }} --body-file comment.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:$HF_TOKEN@huggingface.co/spaces/MakiAi/gradio-mcp-minimal main || true
+          git push --force https://MakiAi:$HF_TOKEN@huggingface.co/spaces/MakiAi/gradio-mcp-minimal 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/a48bdf11-baf1-4e6d-8f4f-10bc33a68551)
+
+
+# 🚀 **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,49 @@
+import os
+import gradio as gr
+
+def letter_counter(text: str, letter: str) -> int:
+    """
+    Count the number of occurrences of a letter in a given text.
+
+    Args:
+        text (str): Text to search through.
+        letter (str): Letter to count.
+
+    Returns:
+        int: How many times `letter` appears in `text`.
+    """
+    return text.lower().count(letter.lower())
+
+# --- Components -----------------------------------------------------------
+# 明示的に label を指定して API 名を関数引数と一致させることで、
+# MCP 経由の JSON キー不一致（"text_1" 問題）を解消するよ ✨
+text_input = gr.Textbox(
+    label="text",
+    placeholder="Enter text here"
+)
+letter_input = gr.Textbox(
+    label="letter",
+    placeholder="Enter a single letter",
+    max_lines=1
+)
+count_output = gr.Number(label="count")
+
+# --- Interface ------------------------------------------------------------
+demo = gr.Interface(
+    fn=letter_counter,
+    inputs=[text_input, letter_input],
+    outputs=count_output,
+    title="Letter Counter (MCP demo)",
+    description="Enter text & a letter – count occurrences. Launches with MCP automatically.",
+    api_name="letter_counter"
+)
+
+if __name__ == "__main__":
+    # mcp_server=True starts the SSE endpoint at /gradio_api/mcp/sse
+    # server_name="0.0.0.0" で全ネットワークインターフェースにバインドし、別PCからアクセス可能にするよ！
+    # PORT 環境変数があればそれを使い、無ければデフォルト 7860✨
+    demo.launch(
+        mcp_server=True,
+        server_name="0.0.0.0",
+        server_port=int(os.getenv("PORT", 7860)),
+    )

requirements.txt

@@ -0,0 +1,2 @@
+mcp
+https://gradio-pypi-previews.s3.amazonaws.com/3b5cace94781b90993b596a83fb39fd1584d68ee/gradio-5.26.0-py3-none-any.whl