PyPI - cc-discussion - Versions diffs - 1.0.2__py3-none-any.whl → 1.0.4__py3-none-any.whl - Mend

cc-discussion 1.0.2py3-none-any.whl → 1.0.4py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

backend/main.py CHANGED Viewed

@@ -11,6 +11,7 @@ load_dotenv()
 import asyncio
 import logging
+import shutil
 import sys
 from contextlib import asynccontextmanager
 from pathlib import Path
@@ -109,25 +110,19 @@ async def health_check():
     return {"status": "healthy"}
-# SDK availability check
+# CLI availability check
 @app.get("/api/config/available-agents")
 async def get_available_agents():
-    """Check which agent SDKs are installed and available."""
+    """Check which CLI tools are installed and available."""
     available = []
-    # Check ClaudeCode SDK
-    try:
-        from claude_agent_sdk import ClaudeSDKClient
+    # Check Claude CLI (claude command)
+    if shutil.which("claude"):
         available.append("claude")
-    except ImportError:
-        pass
-    # Check Codex SDK
-    try:
-        from codex_sdk import Codex
+    # Check Codex CLI (codex command)
+    if shutil.which("codex"):
         available.append("codex")
-    except ImportError:
-        pass
     return {"available_agents": available}

backend/routers/rooms.py CHANGED Viewed

@@ -312,8 +312,10 @@ async def start_discussion(room_id: int, db: Session = Depends(get_db)):
     if room.status == RoomStatus.ACTIVE:
         raise HTTPException(status_code=400, detail="Discussion already active")
+    # Allow resuming from COMPLETED state (reset to WAITING)
     if room.status == RoomStatus.COMPLETED:
-        raise HTTPException(status_code=400, detail="Discussion already completed")
+        room.status = RoomStatus.WAITING
+        db.commit()
     return {
         "status": "ready",

cc_discussion-1.0.4.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,382 @@
+Metadata-Version: 2.4
+Name: cc-discussion
+Version: 1.0.4
+Summary: Multi-Claude discussion platform with ClaudeCode context
+Author: nogataka
+License: MIT
+Project-URL: Homepage, https://github.com/nogataka/cc-discussion
+Project-URL: Repository, https://github.com/nogataka/cc-discussion
+Project-URL: Issues, https://github.com/nogataka/cc-discussion/issues
+Keywords: claude,discussion,ai,multi-agent,codex,openai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: claude-agent-sdk>=0.0.3
+Requires-Dist: codex-sdk-py>=0.0.3
+Provides-Extra: dev
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: mypy>=1.13.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+# cc-discussion
+![Discussion Room Screenshot](docs/assets/screenshot.png)
+複数のClaude/Codexインスタンスが、それぞれ異なるClaudeCode/Codex CLIの会話履歴（コンテキスト）を持ちながらディスカッションできるWebアプリケーションです。
+## クイックスタート
+### インストール不要で実行（推奨）
+```bash
+# uvx で即座に実行（Python 3.11以上が必要）
+uvx cc-discussion
+```
+### pip でインストール
+```bash
+pip install cc-discussion
+cc-discussion
+```
+> **Note**: Claude/Codex エージェントを使用するには、事前に各 CLI ツールのインストールが必要です（下記「必要要件」参照）。
+### 起動オプション
+```bash
+cc-discussion --help
+# カスタムポート
+cc-discussion --port 9000
+# ブラウザを自動で開かない
+cc-discussion --no-browser
+# 開発モード（ホットリロード）
+cc-discussion --reload
+```
+起動後、ブラウザが自動で `http://127.0.0.1:8888` を開きます。
+---
+## 必要要件
+| 要件 | 説明 |
+|------|------|
+| **Python 3.11+** | 必須 |
+| **Claude CLI** | Claude エージェントを使用する場合（インストール・ログイン済み） |
+| **Codex CLI** | Codex エージェントを使用する場合（オプション） |
+### Claude CLI のセットアップ
+```bash
+# Claude CLI をインストール（https://claude.ai/download）
+# インストール後、ログイン
+claude login
+```
+---
+## 概要
+Slackのような会議室を作成し、2〜3人のClaude/Codexを招待してディスカッションさせることができます。各Claude/Codexには過去のClaudeCode/Codex会話履歴を注入できるため、人間がコンテキストを橋渡しする必要なく、問題解決や状況確認を行えます。
+### 主な特徴
+| 機能 | 説明 |
+|------|------|
+| **ClaudeCode/Codex履歴ブラウザ** | `~/.claude/projects/`および`~/.codex/`から過去のセッションを読み込み・選択 |
+| **マルチエージェント会議室** | 2〜3人のClaude/Codex参加者でディスカッション |
+| **コンテキスト注入** | 各エージェントに過去の会話履歴を自動注入 |
+| **リアルタイムストリーミング** | WebSocketでディスカッションをリアルタイム表示 |
+| **並列準備処理** | 次の発言者がバックグラウンドで準備（ファイル読み込み等）を行い、待ち時間を短縮 |
+| **会議タイプ別プロンプト** | 9種類の会議タイプに応じた最適化されたプロンプトを自動適用 |
+| **ファシリテーター機能** | AIファシリテーターが会議を進行・まとめ |
+| **モデレーター介入** | 人間が途中で発言を挿入してディスカッションを誘導可能 |
+---
+## 使い方
+### 1. 会議室を作成
+1. 画面左上の「New Room」ボタンをクリック
+2. 会議設定を入力：
+   - **会議室名**: 識別しやすい名前
+   - **トピック**: ディスカッションのテーマ（詳細に書くほど良い結果に）
+   - **会議タイプ**: 9種類から選択（後述）
+   - **最大ターン数**: 会議の長さを制御（デフォルト: 20）
+   - **言語**: 日本語 or 英語
+3. 参加者を設定（2〜3人）：
+   - **名前**: 表示名（例：Claude A, Claude B）
+   - **役割**: 専門性や視点（例：アーキテクト、コードレビュアー）
+   - **エージェントタイプ**: Claude または Codex
+   - **コンテキスト**: 過去のClaudeCode/Codexセッションを選択（オプション）
+   - **ファシリテーター**: チェックすると会議進行役として動作
+### 2. 会議タイプ
+会議の目的に応じて最適化されたプロンプトが自動適用されます：
+| タイプ | 用途 | 議論のポイント |
+|--------|------|----------------|
+| **進捗・状況確認** | 開発進捗の共有、スケジュール遅延・ブロッカーの把握 | 現在の進捗、予定との差異、ブロッカー特定 |
+| **要件・仕様の認識合わせ** | 要件定義・仕様内容の確認、解釈差分の解消 | 仕様の解釈確認、曖昧点の明確化、エッジケース |
+| **技術検討・設計判断** | アーキテクチャ・技術選定、実装方針の決定 | 選択肢比較、メリデメ、拡張性・保守性 |
+| **課題・不具合対応** | 技術的課題・リスクの洗い出し、不具合の原因分析 | 再現手順、根本原因、対応策、優先度 |
+| **レビュー** | 設計レビュー、実装レビュー、品質確認 | 品質評価、改善点、ベストプラクティス |
+| **計画・タスク整理** | タスク分解、担当者・期限の明確化 | 粒度、依存関係、優先順位、リスク |
+| **リリース・運用判断** | リリース可否判断、デプロイ手順確認 | 品質確認、ロールバック、監視項目 |
+| **改善・振り返り** | 開発プロセスの振り返り、改善アクション決定 | Keep, Problem, Try |
+| **その他** | カスタム説明を入力して自由に設定 | - |
+### 3. コンテキストの選択
+各参加者に過去のClaudeCode/Codex会話履歴を注入できます：
+1. 参加者フォームで「コンテキストを選択」をクリック
+2. **ClaudeCode履歴**: `~/.claude/projects/`から読み込み
+3. **Codex履歴**: `~/.codex/`から読み込み
+4. プロジェクト → セッションの順に選択
+選択したセッションの会話内容が、そのエージェントのシステムプロンプトに注入されます。これにより、エージェントは過去のやり取りを「記憶」した状態で議論に参加できます。
+### 4. ディスカッションの実行
+1. 会議室を作成後、自動的に会議室ページに移動
+2. **Start**ボタンでディスカッション開始
+3. エージェントがラウンドロビン方式で順番に発言
+   - ファシリテーターがいる場合：オープニング → 参加者の議論 → クロージング
+   - いない場合：参加者のみで議論
+4. **Pause**で一時停止、**Stop**で終了
+### 5. 並列準備処理（Parallel Preparation）
+Discussion Roomの特徴的な機能として、**並列準備処理**があります：
+- 現在の発言者が話している間、次の発言者はバックグラウンドで準備
+- 準備中にファイル読み込みやコード検索を実行
+- 準備完了後、即座に発言を開始
+- 待ち時間を大幅に短縮
+### 6. モデレーター介入
+ディスカッション中に人間がモデレーターとして発言を挿入できます：
+1. 画面下部のテキストボックスにメッセージを入力
+2. Enter（またはSendボタン）で送信
+3. 次のエージェントの発言時にモデレーターメッセージが考慮されます
+用途例：
+- 議論の方向性を修正
+- 追加の情報や制約を提供
+- 特定のトピックに焦点を当てるよう指示
+---
+## データの保存場所
+| データ | 保存先 |
+|--------|--------|
+| データベース | `~/.cc-discussion/discussion.db` |
+| ClaudeCode履歴 | `~/.claude/projects/` (読み取り専用) |
+| Codex履歴 | `~/.codex/` (読み取り専用) |
+---
+## 開発者向け
+### ソースからの起動
+```bash
+# リポジトリをクローン
+git clone https://github.com/nogataka/cc-discussion.git
+cd cc-discussion
+# 起動スクリプトを使用（初回は自動セットアップ）
+./start.sh
+# または開発モード
+./start.sh --dev
+```
+### 起動スクリプトオプション
+```bash
+# 通常起動（プロダクションモード）
+./start.sh
+# 開発モード（Viteホットリロード付き）
+./start.sh --dev
+# カスタムポート指定
+./start.sh --port 9000
+# リモートアクセス許可（セキュリティ注意）
+./start.sh --host 0.0.0.0
+```
+### バックエンドのみ起動
+```bash
+source venv/bin/activate
+python -m uvicorn backend.main:app --reload --port 8888
+```
+### フロントエンドのみ起動
+```bash
+cd frontend
+npm run dev
+```
+### ビルド
+```bash
+cd frontend
+npm run build
+```
+### コード品質
+```bash
+# Python linting
+source venv/bin/activate
+ruff check backend/
+mypy backend/
+# TypeScript type check
+cd frontend
+npx tsc --noEmit
+```
+---
+## 技術スタック
+### バックエンド
+| 技術 | 用途 |
+|------|------|
+| **FastAPI** | 非同期REST API・WebSocket |
+| **SQLAlchemy 2.0** | ORM（宣言的マッピング） |
+| **SQLite** | データベース（設定不要） |
+| **Claude Agent SDK** | Claudeエージェント制御 |
+| **Codex SDK** | Codexエージェント制御 |
+### フロントエンド
+| 技術 | 用途 |
+|------|------|
+| **React 19** | UIフレームワーク |
+| **TypeScript** | 型安全性 |
+| **Vite** | ビルドツール・開発サーバー |
+| **Tailwind CSS v4** | ユーティリティファーストCSS |
+| **Radix UI** | アクセシブルUIコンポーネント |
+| **TanStack Query** | サーバー状態管理 |
+---
+## トラブルシューティング
+### エージェントタイプが選択できない
+CLI ツールがインストールされていない可能性があります：
+```bash
+# Claude CLI をインストール
+# https://claude.ai/download からダウンロード
+claude login
+# Codex CLI をインストール
+npm install -g @openai/codex
+```
+### Claude CLIが見つからない
+```bash
+# Claude CLIをインストール（https://claude.ai/download）
+# ログイン
+claude login
+```
+### ポートが使用中
+```bash
+cc-discussion --port 9000
+```
+### データベースのリセット
+```bash
+# データベースファイルを削除（全データ消失）
+rm ~/.cc-discussion/discussion.db
+```
+### Windows での実行
+Windows でも動作します：
+```powershell
+uvx cc-discussion
+# または
+pip install cc-discussion
+cc-discussion
+```
+データは `C:\Users\<username>\.cc-discussion\` に保存されます。
+---
+## API リファレンス
+### 履歴閲覧API
+| メソッド | エンドポイント | 説明 |
+|----------|----------------|------|
+| GET | `/api/history/projects` | ClaudeCodeプロジェクト一覧 |
+| GET | `/api/history/projects/{id}/sessions` | セッション一覧 |
+| GET | `/api/history/sessions/{id}` | セッション詳細 |
+| GET | `/api/history/codex/projects` | Codexプロジェクト一覧 |
+| GET | `/api/history/codex/projects/{id}/sessions` | Codexセッション一覧 |
+### ルーム管理API
+| メソッド | エンドポイント | 説明 |
+|----------|----------------|------|
+| POST | `/api/rooms` | ルーム作成 |
+| GET | `/api/rooms` | ルーム一覧 |
+| GET | `/api/rooms/{id}` | ルーム詳細 |
+| DELETE | `/api/rooms/{id}` | ルーム削除 |
+| POST | `/api/rooms/{id}/start` | ディスカッション開始 |
+| POST | `/api/rooms/{id}/pause` | 一時停止 |
+| POST | `/api/rooms/{id}/moderate` | モデレーター発言 |
+### WebSocket
+| エンドポイント | 説明 |
+|----------------|------|
+| `WS /ws/rooms/{id}` | リアルタイム更新 |
+---
+## ライセンス
+MIT License

{cc_discussion-1.0.2.dist-info → cc_discussion-1.0.4.dist-info}/RECORD RENAMED Viewed

@@ -1,13 +1,13 @@
 backend/__init__.py,sha256=y97v5_UdtKzPNlbudD_L41en48aNR9GB0IJ9atJu-Ew,37
 backend/__main__.py,sha256=z_QVgbG4Qns2lZr5IWmbrYXUgAhbHXQB-vu4_OuUIQ4,119
 backend/cli.py,sha256=U5uqmpab_t7SVFL3Y4UgQqEQ2ZWuwDgCKHvjDjby1kQ,1449
-backend/main.py,sha256=w44n9duN8zI7oGD3rWAV48hlXcLhDlDnq0bfwNyBops,4475
+backend/main.py,sha256=4Hiaoian0YzLy2YE9cLOBXSArgp8scGUUFFvWEmTK98,4397
 backend/websocket.py,sha256=MgKbXaLIOhC8M1R7JJoZ3NCs8S9ZpqmJJkcbWEgrHak,9581
 backend/models/__init__.py,sha256=BQ3qqa1h1lTTfl1jbp97BzE3yvSb0UhKI1fxUZ48IGE,141
 backend/models/database.py,sha256=xwj2iTYdzXwVv2LhvUaK-PdDx5EpZ2x0vjtabfE8beM,8208
 backend/routers/__init__.py,sha256=LxZxYnqJ8lXVpPwCACRqFxAAw6omg6ISeSo3EjC5Fi4,134
 backend/routers/history.py,sha256=co4Ruvz97XOI9p44NoDl3Rw3K0_YFZL0FUnUhbftu0A,5485
-backend/routers/rooms.py,sha256=C_gnM8SdWUZU1LDqjSWc__U-HH8makz4impj4Qzc1e0,11288
+backend/routers/rooms.py,sha256=IdswEYl-DFK_8is6282En41JufTMufOU5z4CusY1lbY,11326
 backend/services/__init__.py,sha256=1Rf_Bz3rS6DwDx7EkAEMsStiKx0iOeuz_vvyKbhkoJE,43
 backend/services/codex_agent.py,sha256=ehx5U3jkCaLsgOwg2B3sAWvYLS5YWioQ3TdM2RwNAto,11858
 backend/services/codex_history_reader.py,sha256=a7zlfWXfoeKg-FuAkEj2azVjQHeSjnlsLgyZs7vzrbE,9803
@@ -23,8 +23,8 @@ backend/static/assets/index-VJBoI-hP.css,sha256=fWJjHYBjJrX8GqLsY1_-gYraM2ThpT7A
 backend/static/assets/vendor-query-b54G1vTo.js,sha256=t_bZMbh6W1n_U5AeG6ujgPLR5aiwmbBCvOgCVc21sVI,35661
 backend/static/assets/vendor-react-BXXBRvhI.js,sha256=CX2NLGw6YdSjTJBejWqA8M1-p97AYh_ZYtt8dpkwmss,47109
 backend/static/assets/vendor-ui-DmKgA75E.js,sha256=oU4ONxMcPBFwUZtEIjofALzbPI1T6mzFLqeG8Rdb6AU,38546
-cc_discussion-1.0.2.dist-info/METADATA,sha256=GCTjGBjStYna4jX6y64C1IN8bYllJzOUlLzy69ClvHI,25865
-cc_discussion-1.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cc_discussion-1.0.2.dist-info/entry_points.txt,sha256=fGx5agzzru7s5NAwuXyB9zNYkiTHihNH4Dzc8kkwRLQ,51
-cc_discussion-1.0.2.dist-info/top_level.txt,sha256=o0r_qMzzBDDtK9APrv2QVcIw9oc00JRmCEsTE2-AFr0,8
-cc_discussion-1.0.2.dist-info/RECORD,,
+cc_discussion-1.0.4.dist-info/METADATA,sha256=WkP3yVmrnzvVaK-9CJYcaJAeqJrOOZaDSO1qjDhLpkw,12639
+cc_discussion-1.0.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cc_discussion-1.0.4.dist-info/entry_points.txt,sha256=fGx5agzzru7s5NAwuXyB9zNYkiTHihNH4Dzc8kkwRLQ,51
+cc_discussion-1.0.4.dist-info/top_level.txt,sha256=o0r_qMzzBDDtK9APrv2QVcIw9oc00JRmCEsTE2-AFr0,8
+cc_discussion-1.0.4.dist-info/RECORD,,

cc_discussion-1.0.2.dist-info/METADATA DELETED Viewed

@@ -1,527 +0,0 @@
-Metadata-Version: 2.4
-Name: cc-discussion
-Version: 1.0.2
-Summary: Multi-Claude discussion platform with ClaudeCode context
-Author: nogataka
-License: MIT
-Project-URL: Homepage, https://github.com/nogataka/cc-discussion
-Project-URL: Repository, https://github.com/nogataka/cc-discussion
-Project-URL: Issues, https://github.com/nogataka/cc-discussion/issues
-Keywords: claude,discussion,ai,multi-agent,codex,openai
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Framework :: FastAPI
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: fastapi>=0.115.0
-Requires-Dist: uvicorn[standard]>=0.32.0
-Requires-Dist: sqlalchemy>=2.0.0
-Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: click>=8.0.0
-Provides-Extra: claude
-Requires-Dist: claude-agent-sdk>=0.0.3; extra == "claude"
-Provides-Extra: codex
-Requires-Dist: codex-sdk-py>=0.0.3; extra == "codex"
-Provides-Extra: all
-Requires-Dist: claude-agent-sdk>=0.0.3; extra == "all"
-Requires-Dist: codex-sdk-py>=0.0.3; extra == "all"
-Provides-Extra: dev
-Requires-Dist: ruff>=0.8.0; extra == "dev"
-Requires-Dist: mypy>=1.13.0; extra == "dev"
-Requires-Dist: build; extra == "dev"
-Requires-Dist: twine; extra == "dev"
-# Discussion Room
-![Discussion Room Screenshot](docs/assets/screenshot.png)
-複数のClaude/Codexインスタンスが、それぞれ異なるClaudeCode/Codex CLIの会話履歴（コンテキスト）を持ちながらディスカッションできるWebアプリケーションです。
-## 概要
-Slackのような会議室を作成し、2〜3人のClaude/Codexを招待してディスカッションさせることができます。各Claude/Codexには過去のClaudeCode/Codex会話履歴を注入できるため、人間がコンテキストを橋渡しする必要なく、問題解決や状況確認を行えます。
-### 主な特徴
-| 機能                             | 説明                                                                           |
-| -------------------------------- | ------------------------------------------------------------------------------ |
-| **ClaudeCode/Codex履歴ブラウザ** | `~/.claude/projects/`および`~/.codex/`から過去のセッションを読み込み・選択     |
-| **マルチエージェント会議室**     | 2〜3人のClaude/Codex参加者でディスカッション                                   |
-| **コンテキスト注入**             | 各エージェントに過去の会話履歴を自動注入                                       |
-| **リアルタイムストリーミング**   | WebSocketでディスカッションをリアルタイム表示                                  |
-| **並列準備処理**                 | 次の発言者がバックグラウンドで準備（ファイル読み込み等）を行い、待ち時間を短縮 |
-| **会議タイプ別プロンプト**       | 9種類の会議タイプに応じた最適化されたプロンプトを自動適用                      |
-| **ファシリテーター機能**         | AIファシリテーターが会議を進行・まとめ                                         |
-| **モデレーター介入**             | 人間が途中で発言を挿入してディスカッションを誘導可能                           |
-## 必要要件
-- Python 3.11以上
-- Node.js 20.19以上 または 22.12以上
-- Claude CLI（インストール済み＆ログイン済み）
-- Codex CLI（オプション：Codexエージェントを使用する場合）
-## インストール・起動
-```bash
-# リポジトリに移動
-cd /path/to/cc-discussion
-# 起動（初回は自動的にセットアップされます）
-./start.sh
-```
-### 起動オプション
-```bash
-# 通常起動（プロダクションモード）
-./start.sh
-# 開発モード（Viteホットリロード付き）
-./start.sh --dev
-# カスタムポート指定
-./start.sh --port 9000
-# リモートアクセス許可（セキュリティ注意）
-./start.sh --host 0.0.0.0
-```
-起動スクリプトは以下を自動的に行います：
-1. Python仮想環境の作成
-2. Python依存関係のインストール
-3. npm依存関係のインストール
-4. Reactフロントエンドのビルド
-5. サーバー起動（デフォルト: http://127.0.0.1:8888）
-6. ブラウザを自動で開く
----
-## 使い方
-### 1. 会議室を作成
-1. 画面左上の「New Room」ボタンをクリック
-2. 会議設定を入力：
-   - **会議室名**: 識別しやすい名前
-   - **トピック**: ディスカッションのテーマ（詳細に書くほど良い結果に）
-   - **会議タイプ**: 9種類から選択（後述）
-   - **最大ターン数**: 会議の長さを制御（デフォルト: 20）
-   - **言語**: 日本語 or 英語
-3. 参加者を設定（2〜3人）：
-   - **名前**: 表示名（例：Claude A, Claude B）
-   - **役割**: 専門性や視点（例：アーキテクト、コードレビュアー）
-   - **エージェントタイプ**: Claude または Codex
-   - **コンテキスト**: 過去のClaudeCode/Codexセッションを選択（オプション）
-   - **ファシリテーター**: チェックすると会議進行役として動作
-### 2. 会議タイプ
-会議の目的に応じて最適化されたプロンプトが自動適用されます：
-| タイプ                     | 用途                                               | 議論のポイント                               |
-| -------------------------- | -------------------------------------------------- | -------------------------------------------- |
-| **進捗・状況確認**         | 開発進捗の共有、スケジュール遅延・ブロッカーの把握 | 現在の進捗、予定との差異、ブロッカー特定     |
-| **要件・仕様の認識合わせ** | 要件定義・仕様内容の確認、解釈差分の解消           | 仕様の解釈確認、曖昧点の明確化、エッジケース |
-| **技術検討・設計判断**     | アーキテクチャ・技術選定、実装方針の決定           | 選択肢比較、メリデメ、拡張性・保守性         |
-| **課題・不具合対応**       | 技術的課題・リスクの洗い出し、不具合の原因分析     | 再現手順、根本原因、対応策、優先度           |
-| **レビュー**               | 設計レビュー、実装レビュー、品質確認               | 品質評価、改善点、ベストプラクティス         |
-| **計画・タスク整理**       | タスク分解、担当者・期限の明確化                   | 粒度、依存関係、優先順位、リスク             |
-| **リリース・運用判断**     | リリース可否判断、デプロイ手順確認                 | 品質確認、ロールバック、監視項目             |
-| **改善・振り返り**         | 開発プロセスの振り返り、改善アクション決定         | Keep, Problem, Try                           |
-| **その他**                 | カスタム説明を入力して自由に設定                   | -                                            |
-### 3. コンテキストの選択
-各参加者に過去のClaudeCode/Codex会話履歴を注入できます：
-1. 参加者フォームで「Select History」をクリック
-2. **ClaudeCode履歴**: `~/.claude/projects/`から読み込み
-3. **Codex履歴**: `~/.codex/`から読み込み
-4. プロジェクト → セッションの順に選択
-選択したセッションの会話内容が、そのエージェントのシステムプロンプトに注入されます。これにより、エージェントは過去のやり取りを「記憶」した状態で議論に参加できます。
-### 4. ディスカッションの実行
-1. 会議室を作成後、自動的に会議室ページに移動
-2. **Start**ボタンでディスカッション開始
-3. エージェントがラウンドロビン方式で順番に発言
-   - ファシリテーターがいる場合：オープニング → 参加者の議論 → クロージング
-   - いない場合：参加者のみで議論
-4. **Pause**で一時停止、**Stop**で終了
-### 5. 並列準備処理（Parallel Preparation）
-Discussion Roomの特徴的な機能として、**並列準備処理**があります：
-- 現在の発言者が話している間、次の発言者はバックグラウンドで準備
-- 準備中にファイル読み込みやコード検索を実行
-- 準備完了後、即座に発言を開始
-- 待ち時間を大幅に短縮
-### 6. モデレーター介入
-ディスカッション中に人間がモデレーターとして発言を挿入できます：
-1. 画面下部のテキストボックスにメッセージを入力
-2. Enter（またはSendボタン）で送信
-3. 次のエージェントの発言時にモデレーターメッセージが考慮されます
-用途例：
-- 議論の方向性を修正
-- 追加の情報や制約を提供
-- 特定のトピックに焦点を当てるよう指示
----
-## 技術スタック
-### バックエンド
-| 技術                 | 用途                      |
-| -------------------- | ------------------------- |
-| **FastAPI**          | 非同期REST API・WebSocket |
-| **SQLAlchemy 2.0**   | ORM（宣言的マッピング）   |
-| **SQLite**           | データベース（設定不要）  |
-| **Claude Agent SDK** | Claudeエージェント制御    |
-| **Codex SDK**        | Codexエージェント制御     |
-| **Pydantic**         | リクエスト/レスポンス検証 |
-### フロントエンド
-| 技術                | 用途                                 |
-| ------------------- | ------------------------------------ |
-| **React 19**        | UIフレームワーク                     |
-| **TypeScript**      | 型安全性                             |
-| **Vite**            | ビルドツール・開発サーバー           |
-| **Tailwind CSS v4** | ユーティリティファーストCSS          |
-| **Radix UI**        | アクセシブルUIコンポーネント         |
-| **TanStack Query**  | サーバー状態管理・データフェッチング |
-| **React Router**    | クライアントサイドルーティング       |
-| **Lucide React**    | アイコン                             |
----
-## アーキテクチャ
-### システム構成図
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         Frontend (React)                         │
-├─────────────────────────────────────────────────────────────────┤
-│  RoomPage.tsx          │  CreateRoomModal.tsx  │  Slack-UI      │
-│  - メッセージ表示      │  - 会議室作成         │  - メッセージ  │
-│  - WebSocket接続       │  - 参加者設定         │  - サイドバー  │
-│  - コントロール        │  - 履歴選択           │  - ステータス  │
-└────────────┬───────────┴───────────┬───────────┴────────────────┘
-             │ HTTP/REST             │ WebSocket
-             ▼                       ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                     Backend (FastAPI)                            │
-├─────────────────────────────────────────────────────────────────┤
-│  main.py               │  rooms.py           │  history.py       │
-│  - アプリ初期化        │  - ルームCRUD       │  - 履歴API       │
-│  - 静的ファイル配信    │  - 制御API          │  - プロジェクト  │
-│  - ライフサイクル      │  - モデレーター     │  - セッション    │
-├─────────────────────────────────────────────────────────────────┤
-│                    websocket.py                                  │
-│  - WebSocket接続管理   - リアルタイム配信   - ルーム別ブロード │
-└────────────────────────────┬────────────────────────────────────┘
-                             │
-                             ▼
-┌─────────────────────────────────────────────────────────────────┐
-│               Services (オーケストレーション)                     │
-├─────────────────────────────────────────────────────────────────┤
-│  parallel_orchestrator.py          │  discussion_orchestrator.py │
-│  - 並列準備処理                    │  - 逐次処理（フォールバック）│
-│  - バックグラウンド準備            │                             │
-│  - イベントキュー                  │                             │
-├─────────────────────────────────────────────────────────────────┤
-│  participant_agent.py              │  codex_agent.py             │
-│  - Claude Agent SDK               │  - Codex SDK                │
-│  - サブプロセス実行               │  - サブプロセス実行         │
-├─────────────────────────────────────────────────────────────────┤
-│  history_reader.py                 │  codex_history_reader.py    │
-│  - ClaudeCode履歴読み込み          │  - Codex履歴読み込み        │
-│  - JSONL解析                       │  - JSONL解析                │
-├─────────────────────────────────────────────────────────────────┤
-│  meeting_prompts.py                                              │
-│  - 会議タイプ別プロンプト          - ファシリテータープロンプト │
-└─────────────────────────────────────────────────────────────────┘
-                             │
-                             ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                    Database (SQLite)                             │
-├─────────────────────────────────────────────────────────────────┤
-│  DiscussionRoom        │  RoomParticipant     │  DiscussionMessage│
-│  - name, topic         │  - name, role        │  - role, content  │
-│  - status              │  - context_*         │  - turn_number    │
-│  - meeting_type        │  - is_facilitator    │  - created_at     │
-│  - max_turns           │  - agent_type        │                   │
-└─────────────────────────────────────────────────────────────────┘
-```
-### ディスカッションフロー
-```
-1. ルーム作成
-   └─> 参加者登録 → コンテキスト読み込み → DB保存
-2. ディスカッション開始 (POST /api/rooms/{id}/start)
-   └─> Orchestrator初期化 → 参加者エージェント生成
-3. ターン実行 (並列準備処理)
-   ┌─────────────────────────────────────────────────────┐
-   │  [発言者A] Speaking ──────────────────────────────► │
-   │  [発言者B] ──── Preparing (background) ─────────►   │
-   │  [発言者C] ──────────── Preparing (background) ──►  │
-   └─────────────────────────────────────────────────────┘
-   各ターン:
-   a. 現在の発言者がレスポンス生成（ストリーミング）
-   b. 次の2名がバックグラウンドで準備
-   c. WebSocket経由でリアルタイム配信
-   d. DB保存 → 次の発言者へ
-4. 完了/一時停止
-   └─> ステータス更新 → クリーンアップ
-```
-### データベースモデル
-```
-DiscussionRoom (会議室)
-├── id: Integer (PK)
-├── name: String(200)
-├── topic: Text (nullable)
-├── status: Enum(waiting/active/paused/completed)
-├── meeting_type: Enum(9種類)
-├── custom_meeting_description: Text (nullable)
-├── language: String(10) = "ja"
-├── max_turns: Integer = 20
-├── current_turn: Integer = 0
-├── created_at: DateTime
-└── updated_at: DateTime
-RoomParticipant (参加者)
-├── id: Integer (PK)
-├── room_id: Integer (FK → DiscussionRoom)
-├── name: String(50)
-├── role: String(100) (nullable)
-├── color: String(7) = "#6366f1"
-├── context_project_dir: String(500) (nullable)
-├── context_session_id: String(100) (nullable)
-├── context_summary: Text (nullable)
-├── is_speaking: Boolean = False
-├── message_count: Integer = 0
-├── is_facilitator: Boolean = False
-└── agent_type: Enum(claude/codex) = claude
-DiscussionMessage (メッセージ)
-├── id: Integer (PK)
-├── room_id: Integer (FK → DiscussionRoom)
-├── participant_id: Integer (FK → RoomParticipant, nullable)
-├── role: String(20) = system/participant/moderator
-├── content: Text
-├── extra_data: JSON (nullable)
-├── turn_number: Integer
-└── created_at: DateTime
-```
----
-## プロジェクト構造
-```
-cc-discussion/
-├── backend/                          # バックエンド（Python/FastAPI）
-│   ├── main.py                       # FastAPIエントリポイント
-│   ├── websocket.py                  # WebSocketハンドラ
-│   ├── models/
-│   │   └── database.py               # SQLAlchemyモデル・Enum定義
-│   ├── routers/
-│   │   ├── history.py                # 履歴閲覧API
-│   │   └── rooms.py                  # ルームCRUD API
-│   └── services/
-│       ├── parallel_orchestrator.py  # 並列準備オーケストレーター
-│       ├── discussion_orchestrator.py# 逐次オーケストレーター
-│       ├── participant_agent.py      # Claudeエージェント
-│       ├── codex_agent.py            # Codexエージェント
-│       ├── history_reader.py         # ClaudeCode履歴パーサー
-│       ├── codex_history_reader.py   # Codex履歴パーサー
-│       └── meeting_prompts.py        # 会議タイプ別プロンプト
-│
-├── frontend/                         # フロントエンド（React/TypeScript）
-│   ├── src/
-│   │   ├── App.tsx                   # メインアプリ・ルーティング
-│   │   ├── main.tsx                  # エントリポイント
-│   │   ├── pages/
-│   │   │   └── RoomPage.tsx          # ディスカッション表示
-│   │   ├── components/
-│   │   │   ├── CreateRoomModal.tsx   # ルーム作成モーダル
-│   │   │   ├── ParticipantAvatar.tsx # 参加者アバター
-│   │   │   ├── ErrorBoundary.tsx     # エラーハンドリング
-│   │   │   ├── slack-ui/             # Slack風UIコンポーネント
-│   │   │   │   ├── ChannelSidebar.tsx
-│   │   │   │   ├── MessageList.tsx
-│   │   │   │   ├── MessageGroup.tsx
-│   │   │   │   ├── MessageInput.tsx
-│   │   │   │   ├── RoomHeader.tsx
-│   │   │   │   └── StatusIndicator.tsx
-│   │   │   └── ui/                   # 汎用UIコンポーネント（shadcn/ui）
-│   │   ├── hooks/
-│   │   │   └── useRoomWebSocket.ts   # WebSocket状態管理
-│   │   └── lib/
-│   │       └── api.ts                # APIクライアント
-│   ├── index.html
-│   ├── vite.config.ts
-│   ├── tailwind.config.ts
-│   └── package.json
-│
-├── start.sh                          # 起動スクリプト（Unix）
-├── start_ui.py                       # Pythonランチャー
-├── requirements.txt                  # Python依存関係
-├── pyproject.toml                    # Python設定
-├── .env.example                      # 環境変数テンプレート
-├── .gitignore                        # Git除外設定
-└── discussion.db                     # SQLiteデータベース（自動生成）
-```
----
-## API リファレンス
-### 履歴閲覧API
-| メソッド | エンドポイント                              | 説明                       |
-| -------- | ------------------------------------------- | -------------------------- |
-| GET      | `/api/history/projects`                     | ClaudeCodeプロジェクト一覧 |
-| GET      | `/api/history/projects/{id}/sessions`       | セッション一覧             |
-| GET      | `/api/history/sessions/{id}`                | セッション詳細             |
-| GET      | `/api/history/codex/projects`               | Codexプロジェクト一覧      |
-| GET      | `/api/history/codex/projects/{id}/sessions` | Codexセッション一覧        |
-### ルーム管理API
-| メソッド | エンドポイント             | 説明                                 |
-| -------- | -------------------------- | ------------------------------------ |
-| POST     | `/api/rooms`               | ルーム作成                           |
-| GET      | `/api/rooms`               | ルーム一覧                           |
-| GET      | `/api/rooms/{id}`          | ルーム詳細（参加者・メッセージ含む） |
-| DELETE   | `/api/rooms/{id}`          | ルーム削除                           |
-| POST     | `/api/rooms/{id}/start`    | ディスカッション開始                 |
-| POST     | `/api/rooms/{id}/pause`    | 一時停止                             |
-| POST     | `/api/rooms/{id}/moderate` | モデレーター発言                     |
-### WebSocket
-| エンドポイント      | 説明                                                 |
-| ------------------- | ---------------------------------------------------- |
-| `WS /ws/rooms/{id}` | リアルタイム更新（メッセージ・ステータス・準備状況） |
-**WebSocketイベントタイプ:**
-- `message`: 新規メッセージ
-- `status_change`: ルームステータス変更
-- `participant_speaking`: 発言者変更
-- `preparation_activity`: 準備中のアクティビティ
-- `preparation_complete`: 準備完了
----
-## 開発
-### バックエンドのみ起動
-```bash
-source venv/bin/activate
-python -m uvicorn backend.main:app --reload --port 8888
-```
-### フロントエンドのみ起動
-```bash
-cd frontend
-npm run dev
-```
-### ビルド
-```bash
-cd frontend
-npm run build
-```
-### コード品質
-```bash
-# Python linting
-source venv/bin/activate
-ruff check backend/
-mypy backend/
-# TypeScript type check
-cd frontend
-npx tsc --noEmit
-```
----
-## トラブルシューティング
-### Claude CLIが見つからない
-```bash
-# Claude CLIをインストール
-# https://claude.ai/download からダウンロード
-# ログイン
-claude login
-```
-### ポートが使用中
-```bash
-# 別のポートを指定
-./start.sh --port 9000
-```
-### 仮想環境の問題
-```bash
-# 仮想環境を削除して再作成
-rm -rf venv
-./start.sh
-```
-### データベースのリセット
-```bash
-# データベースファイルを削除（全データ消失）
-rm discussion.db
-./start.sh
-```
-### Node.jsバージョンの問題
-Vite 7.x は Node.js 20.19+ または 22.12+ を要求します。
-```bash
-# nvm使用時
-nvm install 22
-nvm use 22
-```
----
-## ライセンス
-MIT License

{cc_discussion-1.0.2.dist-info → cc_discussion-1.0.4.dist-info}/WHEEL RENAMED Viewed

File without changes

{cc_discussion-1.0.2.dist-info → cc_discussion-1.0.4.dist-info}/entry_points.txt RENAMED Viewed

File without changes

{cc_discussion-1.0.2.dist-info → cc_discussion-1.0.4.dist-info}/top_level.txt RENAMED Viewed

File without changes

cc-discussion 1.0.2__py3-none-any.whl → 1.0.4__py3-none-any.whl

cc-discussion 1.0.2py3-none-any.whl → 1.0.4py3-none-any.whl