@akiojin/gwt 4.12.2 → 5.1.0

package/README.ja.md

@@ -2,62 +2,104 @@
 
 [English](README.md)
 
-Claude Code / Codex CLI / Gemini CLI 対応の対話型Gitワークツリーマネージャー（グラフィカルなブランチ選択と高度なワークフロー管理機能付き）
+Claude Code / Codex CLI / Gemini CLI / OpenCode 対応の対話型Gitワークツリーマネージャー（グラフィカルなブランチ選択と高度なワークフロー管理機能付き）
 
 ## 概要
 
-`@akiojin/gwt`は、直感的なインターフェースを通じてGitワークツリー管理を革新する強力なCLIツールです。Claude Code / Codex CLI / Gemini CLI の開発ワークフローとシームレスに統合し、インテリジェントなブランチ選択、自動ワークツリー作成、包括的なプロジェクト管理機能を提供します。
+`@akiojin/gwt`は、直感的なインターフェースを通じてGitワークツリー管理を革新する強力なCLIツールです。Claude Code / Codex CLI / Gemini CLI / OpenCode の開発ワークフローとシームレスに統合し、インテリジェントなブランチ選択、自動ワークツリー作成、包括的なプロジェクト管理機能を提供します。
 
-## ✨ 主要機能
+## 移行ステータス
 
-- 🎯 **モダンOpenTUIベースUI**: OpenTUI + SolidJSによるスムーズでレスポンシブなターミナルインターフェースとリアルタイム更新
-- 🖼️ **フルスクリーンレイアウト**: 統計情報付きの固定ヘッダー、スクロール可能なブランチリスト、キーボードショートカット付きの常時表示フッター
-- 🌟 **スマートブランチ作成**: ガイド付きプロンプトと自動ベースブランチ選択でfeature、bugfix、hotfix、releaseブランチを作成
-- 🔄 **高度なワークツリー管理**: 作成、クリーンアップ、パス最適化を含む完全なライフサイクル管理
-- 🤖 **Coding Agent 選択**: 起動時の対話型ランチャーで Claude Code / Codex CLI / Gemini CLI を選択
-- 🚀 **Coding Agent 統合**: 選択したコーディングエージェントをワークツリーで起動（Claude Codeは権限設定・変更処理の統合あり）
-- 🔒 **ワークツリーコマンド制限**: PreToolUse hooksによりワークツリー境界を強制し、ディレクトリ移動、ブランチ切替、ワークツリー外のファイル操作をブロック
-- 📊 **GitHub PR統合**: マージされたプルリクエストのブランチとワークツリーの自動クリーンアップ
-- 🛠️ **変更管理**: 開発セッション後のコミット、stash、破棄の内蔵サポート
-- 📦 **ユニバーサルパッケージ**: 一度インストールすれば全プロジェクトで一貫した動作
-- 🔍 **リアルタイム統計**: 自動ターミナルリサイズ対応でブランチ・ワークツリー数をライブ更新
+Rust版はCLI/TUIの主要フローとWeb UI（REST + WebSocket端末）まで実装済みです。残作業はGitバックエンドのフォールバック範囲の整理、ドキュメント整備、リリース周りの調整に集中しています。
+
+## 主要機能
+
+- **モダンTUI**: Ratatuiによるスムーズでレスポンシブなターミナルインターフェース
+- **フルスクリーンレイアウト**: リポジトリ情報付きの固定ヘッダー、枠線付きのブランチリスト、キーボードショートカット付きの常時表示フッター
+- **スマートブランチ作成**: ガイド付きプロンプトと自動ベースブランチ選択でfeature、bugfix、hotfix、releaseブランチを作成
+- **高度なワークツリー管理**: 作成、Worktreeのあるブランチのクリーンアップ、パス最適化を含む完全なライフサイクル管理
+- **Coding Agent 選択**: 起動時の対話型ランチャーでビルトイン（Claude Code / Codex CLI / Gemini CLI / OpenCode）または `~/.gwt/tools.json` 定義のカスタムを選択
+- **Coding Agent 統合**: 選択したコーディングエージェントをワークツリーで起動（Claude Codeは権限設定・変更処理の統合あり）
+- **GitHub PR統合**: マージされたプルリクエストのブランチとワークツリーの自動クリーンアップ
+- **変更管理**: 開発セッション後のコミット、stash、破棄の内蔵サポート
+- **ユニバーサルパッケージ**: 一度インストールすれば全プロジェクトで一貫した動作
 
 ## インストール
 
-### グローバルインストール（推奨）
+GitHub Releases を正とし、npm/bunx では該当リリースのバイナリをダウンロードして実行します。
+
+### GitHub Releasesから（推奨）
 
-永続的なアクセスのためにグローバルインストール:
+[Releasesページ](https://github.com/akiojin/gwt/releases)からプリビルドバイナリをダウンロード:
 
-#### bun（グローバルインストール）
+- `gwt-linux-x86_64` - Linux x86_64
+- `gwt-linux-aarch64` - Linux ARM64
+- `gwt-macos-x86_64` - macOS Intel
+- `gwt-macos-aarch64` - macOS Apple Silicon
+- `gwt-windows-x86_64.exe` - Windows x86_64
 
 ```bash
-bun add -g @akiojin/gwt
+# Linux x86_64の例
+curl -L https://github.com/akiojin/gwt/releases/latest/download/gwt-linux-x86_64 -o gwt
+chmod +x gwt
+sudo mv gwt /usr/local/bin/
 ```
 
-### 一回限りの使用
-
-インストールせずに実行:
+### npm/bunx経由
 
-#### bunx (bun)
+グローバルインストールまたはインストールなしで実行:
 
 ```bash
+# グローバルインストール
+npm install -g @akiojin/gwt
+bun add -g @akiojin/gwt
+
+# 一回限りの実行
+npx @akiojin/gwt
 bunx @akiojin/gwt
 ```
 
-> 注意（Linux）: `node-gyp` のエラー（例: `Error: not found: make`）でインストールに失敗する場合、`node-pty` などのネイティブ依存をビルドするためのツールが不足しています。`linux/arm64` や `node:* -slim` のような最小イメージで起きやすいです。
->
-> - Debian/Ubuntu: `apt-get update && apt-get install -y build-essential`
-> - Alpine: `apk add --no-cache build-base python3`
+### Cargo 経由
+
+Cargo で CLI を直接インストールできます:
+
+```bash
+# crates.io からインストール（Rustユーザー推奨）
+cargo install gwt-cli
+
+# cargo-binstall でインストール（高速、プリビルドバイナリをダウンロード）
+cargo binstall gwt-cli
+
+# GitHub からインストール（最新開発版）
+cargo install --git https://github.com/akiojin/gwt --package gwt-cli --bin gwt --locked
+
+# ローカルチェックアウトからインストール
+cargo install --path crates/gwt-cli
+```
+
+### ソースからビルド
+
+```bash
+# リポジトリをクローン
+git clone https://github.com/akiojin/gwt.git
+cd gwt
+
+# リリースバイナリをビルド
+cargo build --release
+
+# バイナリは target/release/gwt にあります
+./target/release/gwt
+```
 
 ## クイックスタート
 
 任意のGitリポジトリで実行:
 
 ```bash
-# グローバルインストール済みの場合
+# グローバルインストール済みまたはPATHに追加済みの場合
 gwt
 
-# または一回限りの実行に bunx を使用
+# または一回限りの実行にbunxを使用
 bunx @akiojin/gwt
 ```
 
@@ -69,8 +111,21 @@ gwt --help
 
 # バージョンを確認
 gwt --version
-# または
-gwt -v
+
+# ワークツリー一覧
+gwt list
+
+# 既存ブランチ用のワークツリーを追加
+gwt add feature/my-feature
+
+# 新規ブランチとワークツリーを作成
+gwt add -n feature/new-feature --base develop
+
+# ワークツリーを削除
+gwt remove feature/old-feature
+
+# 孤立したワークツリーをクリーンアップ
+gwt clean
 ```
 
 ツールは以下のオプションを持つ対話型インターフェースを提供します:
@@ -78,39 +133,54 @@ gwt -v
 1. **既存ブランチを選択**: ワークツリー自動作成機能付きでローカル・リモートブランチから選択
 2. **新規ブランチ作成**: タイプ選択（feature/bugfix/hotfix/release）によるガイド付きブランチ作成
 3. **ワークツリー管理**: 既存ワークツリーの表示、オープン、削除
-4. **ブランチクリーンアップ**: マージ済みPRやベースブランチと差分がないブランチ／ワークツリーをローカルから自動削除
+4. **ブランチクリーンアップ**: マージ済みPRやベースブランチと差分がないブランチ／ワークツリーをローカルから自動削除（Worktreeのないブランチは対象外）
 
-## Web UI とカスタム Coding Agent
+## コーディングエージェント
 
-### Web UI の起動
+gwt は PATH 上のエージェントを検出し、ランチャーに表示します。
 
-```bash
-# CLI を起動します
-gwt
+対応エージェント（ビルトイン）:
 
-# Web UI サーバーを起動します
-gwt serve
-# または
-bunx @akiojin/gwt serve
-```
+- Claude Code (`claude`)
+- Codex CLI (`codex`)
+- Gemini CLI (`gemini`)
+- OpenCode (`opencode`)
 
-- Web UI はデフォルトで <http://localhost:3000> で利用できます
-- システムトレイ常駐は現時点では **Windows のみ対応** です（macOS/Linux では自動で無効化されます）
-- ブランチ一覧はCLIビューと同等で、検索とワークツリー作成を含む
-- ブランチ詳細ページからCoding Agentセッションを直接開始可能
+### カスタムコーディングエージェント
 
-### カスタム Coding Agent の管理
+カスタムエージェントは `~/.gwt/tools.json` に定義するとランチャーに表示されます。
+
+最小例:
+
+```json
+{
+  "version": "1.0.0",
+  "customCodingAgents": [
+    {
+      "id": "aider",
+      "displayName": "Aider",
+      "type": "command",
+      "command": "aider",
+      "defaultArgs": ["--no-git"],
+      "modeArgs": {
+        "normal": [],
+        "continue": ["--resume"],
+        "resume": ["--resume"]
+      },
+      "permissionSkipArgs": ["--yes"],
+      "env": {
+        "OPENAI_API_KEY": "sk-..."
+      }
+    }
+  ]
+}
+```
 
-- ダッシュボード右上の **Config**（または `/config` URL）で `~/.gwt/tools.json` を表示・編集
-- 実行タイプ（`path` / `bunx` / `command`）、デフォルト引数、モード別引数、権限スキップ引数、環境変数を追加・編集
-- 変更内容はCLIが使用する同じ `tools.json` ファイルに書き込まれるため、両チャネルで同期
-- ブランチ詳細ページからの起動時に設定可能:
-  - 任意のカスタム Coding Agent を選択
-  - `normal` / `continue` / `resume` モードを選択
-  - 追加引数を追記
-  - CLIと同等の `--dangerously-skip-permissions` フローを有効化（確認付き）
+補足:
 
-> ヒント: Web UI を使用してカスタム Coding Agent 定義を素早く調整し、JSON を手動編集せずに CLI またはブラウザから実行できます。
+- `type` は `path` / `bunx` / `command` を指定します。
+- `modeArgs` で実行モード別の引数を定義します（Normal/Continue/Resume）。
+- `env` はエージェントごとの環境変数（任意）です。
 
 ## 高度なワークフロー
 
@@ -160,112 +230,29 @@ gwt
 - **認証確認**: 操作前にGitHub CLIセットアップを検証
 - **リモート同期**: クリーンアップ操作前に最新変更を取得
 
-### PR自動マージ
-
-リポジトリには、開発プロセスを効率化するPR自動マージワークフローが含まれています：
-
-- **自動マージ**: すべてのCIチェック（Test、Lint）が成功し、競合がない場合、PRを自動的にマージ
-- **マージ方法**: マージコミットを使用して完全なコミット履歴を保持
-- **スマートスキップロジック**: ドラフトPR、競合のあるPR、CI失敗時は自動的にスキップ
-- **対象ブランチ**: `develop`ブランチへのPRで有効（機能統合）
-- **安全第一**: ブランチ保護ルールを尊重し、CI成功を必須条件とする
-
-**動作の仕組み:**
-
-1. `develop`を対象とするPRを作成
-2. CIワークフロー（Test、Lint）が自動実行
-3. すべてのCIチェックが成功し、競合がない場合、PRが自動的に`develop`にマージされる
-4. 変更は`develop`に蓄積され、リリース準備ができるまで待機
-5. `/release`コマンドを使用してRelease PRを作成し、release-pleaseをトリガー
-
-**自動マージの無効化:**
-
-- ドラフトPRとして作成すると自動マージを防げます: `gh pr create --draft`
-- 自動マージワークフローはこの設定を尊重し、ドラフトPRはスキップします
-
-技術的な詳細については、`.github/workflows/auto-merge.yml` ワークフローファイルを参照してください。
-
 ## システム要件
 
-- **Bun**: >= 1.0.0
-- **Node.js**（任意）: Nodeベースの開発ツール利用時は >= 18.0.0 を推奨
-- **pnpm**: >= 8.0.0（CI/CD・Docker環境用 - ハードリンクによるnode_modules効率化）
+- **Rust**: Stableツールチェーン（ソースからビルドする場合）
 - **Git**: ワークツリーサポート付き最新版
-- **Coding Agent**: 少なくともいずれかが必要（Claude Code、Codex CLI、または Gemini CLI）
+- **Coding Agent**: 少なくともビルトインまたはカスタムのいずれかが必要
 - **GitHub CLI**: PR クリーンアップ機能に必要（オプション）
-- **Python**: >= 3.11（Spec Kit CLIに必要）
-- **uv**: Pythonパッケージマネージャー（Spec Kit CLIに必要）
-- **ビルドツール**（Linux）: ネイティブ依存がソースビルドに回る場合、`make` と C/C++ ツールチェーンが必要です（`linux/arm64` や最小Dockerイメージで起きやすい）
-
-## Spec Kit による仕様駆動開発
-
-このプロジェクトは、仕様駆動開発ワークフローのために **@akiojin/spec-kit**（GitHub Spec Kit の日本語対応版）を使用しています。
-
-### Spec Kit CLI のインストール
-
-```bash
-# uvでグローバルインストール
-uv tool install specify-cli --from git+https://github.com/akiojin/spec-kit.git
-
-# インストール確認
-specify --help
-```
-
-### 利用可能な Spec Kit コマンド
-
-Claude Code で以下のコマンドを実行して、仕様駆動開発を活用できます：
-
-- `/speckit.constitution` - プロジェクト原則とガイドラインを定義
-- `/speckit.specify` - 機能仕様書を作成
-- `/speckit.plan` - 技術実装計画を作成
-- `/speckit.tasks` - 実行可能なタスクリストを生成
-- `/speckit.implement` - 実装を実行
-
-### 品質保証用オプションコマンド
-
-- `/speckit.clarify` - 計画前に曖昧な領域を解消
-- `/speckit.analyze` - 仕様、計画、タスク間の整合性を検証
-- `/speckit.checklist` - 要件の網羅性と明確性を検証
-
-### Spec Kit ワークフロー
-
-1. `/speckit.constitution` でプロジェクトの基礎を確立
-2. `/speckit.specify` で構築したいものを定義
-3. `/speckit.plan` で技術アーキテクチャを作成
-4. `/speckit.tasks` でタスクを生成
-5. `/speckit.implement` で実装を実行
-
-詳細は [Spec Kit ドキュメント](https://github.com/akiojin/spec-kit) を参照してください。
+- **bun/npm**: bunx/npx実行方式に必要
 
 ## プロジェクト構造
 
-```
+```text
 @akiojin/gwt/
-├── src/
-│   ├── cli/
-│   │   └── ui/          # OpenTUI + SolidJSコンポーネントによるターミナルUI
-│   ├── web/             # Web UIサーバー（Express + React）
-│   ├── services/        # コアビジネスロジック
-│   ├── repositories/    # データアクセス層
-│   ├── config/          # 設定管理
-│   ├── logging/         # 構造化ログ（pino）
-│   ├── shared/          # 共有ユーティリティと型
-│   └── types/           # TypeScript型定義
-├── bin/
-│   └── gwt.js # 実行可能ラッパー
-├── .claude/             # Claude Code 設定
-│   ├── commands/        # Spec Kit スラッシュコマンド
-│   ├── settings.json    # Hook設定
-│   └── hooks/           # コマンド制限用PreToolUse hooks
-│       ├── block-cd-command.sh        # cdコマンドをワークツリー内に制限
-│       ├── block-git-branch-ops.sh    # git ブランチ操作を制御
-│       └── block-file-ops.sh          # ファイル操作をワークツリー内に制限
-├── .specify/            # Spec Kit スクリプトとテンプレート
-│   ├── memory/          # プロジェクトメモリファイル
-│   ├── scripts/         # 自動化スクリプト
-│   └── templates/       # 仕様書テンプレート
+├── Cargo.toml           # ワークスペース設定
+├── crates/
+│   ├── gwt-cli/         # CLIエントリポイントとTUI（Ratatui）
+│   ├── gwt-core/        # コアライブラリ（ワークツリー管理）
+│   ├── gwt-web/         # Webサーバー（将来）
+│   └── gwt-frontend/    # Webフロントエンド（将来）
+├── package.json         # npm配布用ラッパー
+├── bin/gwt.js           # バイナリラッパースクリプト
+├── scripts/postinstall.js  # バイナリダウンロードスクリプト
 ├── specs/               # 機能仕様書
-└── dist/                # コンパイル済みJavaScript出力
+└── docs/                # ドキュメント
 ```
 
 ## 開発
@@ -277,64 +264,54 @@ Claude Code で以下のコマンドを実行して、仕様駆動開発を活
 git clone https://github.com/akiojin/gwt.git
 cd gwt
 
-# 依存関係をインストール（bun）
-bun install
+# プロジェクトをビルド
+cargo build
 
-# プロジェクトをビルド（bun）
-bun run build
+# テストを実行
+cargo test
+
+# デバッグ出力付きで実行
+cargo run
 ```
 
-### 利用可能なスクリプト
+### 利用可能なコマンド
 
 ```bash
-# 自動リビルド付き開発モード（bun）
-bun run dev
+# 開発ビルド
+cargo build
 
-# プロダクションビルド（bun）
-bun run build
+# リリースビルド
+cargo build --release
 
-# 型チェック（bun）
-bun run type-check
+# テスト実行
+cargo test
 
-# コードリンティング（bun）
-bun run lint
+# clippy lint実行
+cargo clippy --all-targets --all-features -- -D warnings
 
-# ビルド成果物をクリーン（bun）
-bun run clean
+# コードフォーマット
+cargo fmt
 
-# CLIをローカルテスト（bun）
-bun run start
+# CLIをローカル実行
+cargo run
 ```
 
 ### 開発ワークフロー
 
 1. **フォークとクローン**: リポジトリをフォークし、あなたのフォークをクローン
 2. **ブランチ作成**: ツール自体を使用してfeatureブランチを作成
-3. **開発**: TypeScriptサポート付きで変更を実施
-4. **テスト**: `bun run start`でCLI機能をテスト
-5. **品質チェック**: `bun run type-check`と`bun run lint`を実行
+3. **開発**: Rustで変更を実施
+4. **テスト**: `cargo run`でCLI機能をテスト
+5. **品質チェック**: `cargo clippy`と`cargo fmt --check`を実行
 6. **プルリクエスト**: 明確な説明付きでPRを提出
 
 ### コード構造
 
-- **エントリーポイント**: `src/index.ts` - メインアプリケーションロジック
-- **コアモジュール**: Git操作、ワークツリー管理、Claude統合
-- **UIコンポーネント**: `src/ui/`のモジュラーインターフェースコンポーネント
-- **型安全性**: 包括的なTypeScript定義
-- **エラーハンドリング**: 全モジュールにわたる堅牢なエラー管理
-
-## 統合例
-
-### カスタムスクリプト
-
-```bash
-# Package.jsonスクリプト例
-{
-  "scripts": {
-    "worktree": "gwt"
-  }
-}
-```
+- **エントリーポイント**: `crates/gwt-cli/src/main.rs` - メインアプリケーションロジック
+- **コアモジュール**: Git操作、ワークツリー管理は`gwt-core`に
+- **TUIコンポーネント**: `gwt-cli/src/tui/`のRatatuiベースインターフェース
+- **型安全性**: 包括的なRust型定義
+- **エラーハンドリング**: `thiserror`による堅牢なエラー管理
 
 ## リリースプロセス
 
@@ -344,18 +321,17 @@ bun run start
 
 ### よくある問題
 
-**権限エラー**: Claude Codeが適切なディレクトリ権限を持っていることを確認  
-**Git ワークツリー競合**: クリーンアップ機能を使用して古いワークツリーを削除  
-**GitHub認証**: PRクリーンアップ機能使用前に`gh auth login`を実行  
-**node-gyp / node-pty ビルドエラー**: `Error: not found: make` の場合は `build-essential`（Debian/Ubuntu）や `build-base`（Alpine）をインストール  
-**Bunバージョン**: `bun --version`でBun >= 1.0.0を確認
+**権限エラー**: 適切なディレクトリ権限があることを確認
+**Git ワークツリー競合**: クリーンアップ機能を使用して古いワークツリーを削除
+**GitHub認証**: PRクリーンアップ機能使用前に`gh auth login`を実行
+**バイナリが見つからない**: gwtバイナリがPATHに含まれていることを確認
 
 ### デバッグモード
 
 詳細出力には環境変数を設定:
 
 ```bash
-DEBUG=gwt gwt
+GWT_DEBUG=1 gwt
 ```
 
 ## ライセンス
@@ -368,7 +344,7 @@ MIT - 詳細はLICENSEファイルを参照
 
 1. **Issues**: GitHub IssuesでバグレポートやFeatureリクエストを報告
 2. **プルリクエスト**: 上記の開発ワークフローに従う
-3. **コードスタイル**: TypeScriptベストプラクティスと既存パターンを維持
+3. **コードスタイル**: Rustベストプラクティスと既存パターンを維持
 4. **ドキュメント**: 重要な変更についてはREADMEとコードコメントを更新
 
 ### 貢献者
@@ -381,9 +357,3 @@ MIT - 詳細はLICENSEファイルを参照
 - **ドキュメント**: このREADMEとインラインコードドキュメント
 - **Issues**: バグレポートとFeatureリクエスト用のGitHub Issues
 - **ディスカッション**: 質問とコミュニティサポート用のGitHub Discussions
-
-### アイコン凡例
-
-- 先頭3枠: ⚡(main/develop) / ✨(feature) / 🐛(bugfix) / 🔥(hotfix) / 📦(release) / 📌(other)、🟢=ワークツリーあり、🔴=ワークツリーあり(アクセス不可)、✏️=未コミット、⚠️=警告、⭐=現在ブランチ
-- 配置枠: 空白=ローカルが存在、`☁`=リモートのみ存在
-- 選択枠: カラー環境では背景反転を用いず `>`プレフィックス（スペース付き）で選択中を表示