@akiojin/gwt 2.0.0

package/README.ja.md

@@ -0,0 +1,323 @@
+# @akiojin/gwt
+
+[English](README.md)
+
+Claude Code / Codex CLI 対応の対話型Gitワークツリーマネージャー（グラフィカルなブランチ選択と高度なワークフロー管理機能付き）
+
+## 概要
+
+`@akiojin/gwt`は、直感的なインターフェースを通じてGitワークツリー管理を革新する強力なCLIツールです。Claude Code / Codex CLI の開発ワークフローとシームレスに統合し、インテリジェントなブランチ選択、自動ワークツリー作成、包括的なプロジェクト管理機能を提供します。
+
+## ✨ 主要機能
+
+- 🎯 **対話型ブランチ選択**: ブランチ種別・ワークツリー・変更状態アイコンに加え配置インジケータ枠（左=L, 右=R, リモートのみ=☁）で所在を示し、リモート名の `origin/` を省いたシンプルなリストで判別しやすく、現在の選択は `>` プレフィックスで強調されるため誤操作を防止
+- 🌟 **スマートブランチ作成**: ガイド付きプロンプトと自動ベースブランチ選択でfeature、hotfix、releaseブランチを作成
+- 🔄 **高度なワークツリー管理**: 作成、クリーンアップ、パス最適化を含む完全なライフサイクル管理
+- 🤖 **AIツール選択**: 起動時の対話型ランチャーで Claude Code / Codex CLI を選択
+- 🚀 **AIツール統合**: 選択したツールをワークツリーで起動（Claude Codeは権限設定・変更処理の統合あり）
+- 📊 **GitHub PR統合**: マージされたプルリクエストのブランチとワークツリーの自動クリーンアップ
+- 🛠️ **変更管理**: 開発セッション後のコミット、stash、破棄の内蔵サポート
+- 📦 **ユニバーサルパッケージ**: 一度インストールすれば全プロジェクトで一貫した動作
+- 🔍 **リポジトリ統計**: プロジェクト概要の向上のためのブランチとワークツリー数のリアルタイム表示
+
+## インストール
+
+### グローバルインストール（推奨）
+
+永続的なアクセスのためにグローバルインストール:
+
+#### bun（グローバルインストール）
+
+```bash
+bun add -g @akiojin/gwt
+```
+
+### 一回限りの使用
+
+インストールせずに実行:
+
+#### bunx (bun)
+
+```bash
+bunx @akiojin/gwt
+```
+
+## クイックスタート
+
+任意のGitリポジトリで実行:
+
+```bash
+# グローバルインストール済みの場合
+gwt
+
+# または一回限りの実行に bunx を使用
+bunx @akiojin/gwt
+```
+
+CLIオプション:
+
+```bash
+# ヘルプを表示
+gwt --help
+
+# バージョンを確認
+gwt --version
+# または
+gwt -v
+```
+
+ツールは以下のオプションを持つ対話型インターフェースを提供します:
+
+1. **既存ブランチを選択**: ワークツリー自動作成機能付きでローカル・リモートブランチから選択
+2. **新規ブランチ作成**: タイプ選択（feature/hotfix/release）によるガイド付きブランチ作成
+3. **ワークツリー管理**: 既存ワークツリーの表示、オープン、削除
+4. **ブランチクリーンアップ**: マージ済みPRやベースブランチと差分がないブランチ／ワークツリーをローカルから自動削除
+
+## 高度なワークフロー
+
+### ブランチ作成ワークフロー
+
+> **重要**: このワークフローは人間の開発者向けです。エージェントは、ユーザーから明確かつタスク固有の指示がない限り、ブランチの作成や削除を絶対に行ってはいけません。
+
+1. メインメニューから「新規ブランチ作成」を選択
+2. ブランチタイプ（feature、hotfix、release）を選択
+3. 自動プレフィックス適用でブランチ名を入力
+4. 利用可能なオプションからベースブランチを選択
+5. ワークツリー作成パスを確認
+6. 自動ワークツリーセットアップと選択ツールの起動
+
+### ワークツリー管理
+
+- **既存を開く**: 既存ワークツリーで選択ツールを起動
+- **ワークツリー削除**: オプションのブランチ削除付きクリーン削除
+- **バッチ操作**: 複数ワークツリーの効率的な処理
+
+### GitHub統合
+
+- **ブランチクリーンアップ**: マージ済みPRやベースブランチと差分がないブランチを自動検出して安全に削除
+- **認証確認**: 操作前に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`コマンドを使用して`develop`を`main`にマージし、semantic-releaseをトリガー
+
+**自動マージの無効化:**
+
+- ドラフトPRとして作成すると自動マージを防げます: `gh pr create --draft`
+- 自動マージワークフローはこの設定を尊重し、ドラフトPRはスキップします
+
+技術的な詳細については、[specs/SPEC-cff08403/](specs/SPEC-cff08403/)を参照してください。
+
+## システム要件
+
+- **Bun**: >= 1.0.0
+- **Node.js**（任意）: Nodeベースの開発ツール利用時は >= 18.0.0 を推奨
+- **pnpm**: >= 8.0.0（CI/CD・Docker環境用 - ハードリンクによるnode_modules効率化）
+- **Git**: ワークツリーサポート付き最新版
+- **AIツール**: 少なくともいずれかが必要（Claude Code もしくは Codex CLI）
+- **GitHub CLI**: PR クリーンアップ機能に必要（オプション）
+- **Python**: >= 3.11（Spec Kit CLIに必要）
+- **uv**: Pythonパッケージマネージャー（Spec Kit CLIに必要）
+
+## 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) を参照してください。
+
+## プロジェクト構造
+
+```
+@akiojin/gwt/
+├── src/
+│   ├── index.ts          # メインアプリケーションエントリーポイント
+│   ├── git.ts           # Git操作とブランチ管理
+│   ├── worktree.ts      # ワークツリー作成と管理
+│   ├── claude.ts        # Claude Code 統合
+│   ├── codex.ts         # Codex CLI 統合
+│   ├── github.ts        # GitHub CLI統合
+│   ├── utils.ts         # ユーティリティ関数とエラーハンドリング
+│   └── ui/              # ユーザーインターフェースコンポーネント
+│       ├── display.ts   # コンソール出力フォーマット
+│       ├── prompts.ts   # 対話型プロンプト
+│       ├── table.ts     # ブランチテーブル生成
+│       └── types.ts     # TypeScript型定義
+├── bin/
+│   └── gwt.js # 実行可能ラッパー
+├── .claude/             # Claude Code 設定
+│   └── commands/        # Spec Kit スラッシュコマンド
+├── .specify/            # Spec Kit スクリプトとテンプレート
+│   ├── memory/          # プロジェクトメモリファイル
+│   ├── scripts/         # 自動化スクリプト
+│   └── templates/       # 仕様書テンプレート
+├── specs/               # 機能仕様書
+└── dist/                # コンパイル済みJavaScript出力
+```
+
+## 開発
+
+### セットアップ
+
+```bash
+# リポジトリをクローン
+git clone https://github.com/akiojin/gwt.git
+cd gwt
+
+# 依存関係をインストール（bun）
+bun install
+
+# プロジェクトをビルド（bun）
+bun run build
+```
+
+### 利用可能なスクリプト
+
+```bash
+# 自動リビルド付き開発モード（bun）
+bun run dev
+
+# プロダクションビルド（bun）
+bun run build
+
+# 型チェック（bun）
+bun run type-check
+
+# コードリンティング（bun）
+bun run lint
+
+# ビルド成果物をクリーン（bun）
+bun run clean
+
+# CLIをローカルテスト（bun）
+bun run start
+```
+
+### 開発ワークフロー
+
+1. **フォークとクローン**: リポジトリをフォークし、あなたのフォークをクローン
+2. **ブランチ作成**: ツール自体を使用してfeatureブランチを作成
+3. **開発**: TypeScriptサポート付きで変更を実施
+4. **テスト**: `bun run start`でCLI機能をテスト
+5. **品質チェック**: `bun run type-check`と`bun run lint`を実行
+6. **プルリクエスト**: 明確な説明付きでPRを提出
+
+### コード構造
+
+- **エントリーポイント**: `src/index.ts` - メインアプリケーションロジック
+- **コアモジュール**: Git操作、ワークツリー管理、Claude統合
+- **UIコンポーネント**: `src/ui/`のモジュラーインターフェースコンポーネント
+- **型安全性**: 包括的なTypeScript定義
+- **エラーハンドリング**: 全モジュールにわたる堅牢なエラー管理
+
+## 統合例
+
+### カスタムスクリプト
+
+```bash
+# Package.jsonスクリプト例
+{
+  "scripts": {
+    "worktree": "gwt"
+  }
+}
+```
+
+## リリースプロセス
+
+利用者の方は GitHub Releases もしくは npm で公開される最新版をご利用ください。リリース自動化の概要は [docs/release-guide.md](./docs/release-guide.md)（日本語版: [docs/release-guide.ja.md](./docs/release-guide.ja.md)）にまとめており、詳細設計は `specs/SPEC-57fde06f/` を参照してください。
+
+## トラブルシューティング
+
+### よくある問題
+
+**権限エラー**: Claude Codeが適切なディレクトリ権限を持っていることを確認  
+**Git ワークツリー競合**: クリーンアップ機能を使用して古いワークツリーを削除  
+**GitHub認証**: PRクリーンアップ機能使用前に`gh auth login`を実行  
+**Bunバージョン**: `bun --version`でBun >= 1.0.0を確認
+
+### デバッグモード
+
+詳細出力には環境変数を設定:
+
+```bash
+DEBUG=gwt gwt
+```
+
+## ライセンス
+
+MIT - 詳細はLICENSEファイルを参照
+
+## 貢献
+
+貢献を歓迎します！以下の貢献ガイドラインをお読みください:
+
+1. **Issues**: GitHub IssuesでバグレポートやFeatureリクエストを報告
+2. **プルリクエスト**: 上記の開発ワークフローに従う
+3. **コードスタイル**: TypeScriptベストプラクティスと既存パターンを維持
+4. **ドキュメント**: 重要な変更についてはREADMEとコードコメントを更新
+
+### 貢献者
+
+- AI Novel Project Team
+- コミュニティ貢献者歓迎
+
+## サポート
+
+- **ドキュメント**: このREADMEとインラインコードドキュメント
+- **Issues**: バグレポートとFeatureリクエスト用のGitHub Issues
+- **ディスカッション**: 質問とコミュニティサポート用のGitHub Discussions
+
+### アイコン凡例
+
+- 先頭3枠: ⚡(main/develop) / ✨(feature) / 🔥(hotfix) / 📦(release) / 📌(other)、🟢=ワークツリーあり、🟠=ワークツリーあり(アクセス不可)、✏️=未コミット、⚠️=警告、⭐=現在ブランチ
+- 配置枠: 空白=ローカルが存在、`☁`=リモートのみ存在
+- 選択枠: カラー環境では背景反転を用いず `>`プレフィックス（スペース付き）で選択中を表示

package/README.md

@@ -0,0 +1,347 @@
+# @akiojin/gwt
+
+[日本語](README.ja.md)
+
+Interactive Git worktree manager with AI tool selection (Claude Code / Codex CLI), graphical branch selection, and advanced workflow management.
+
+## Overview
+
+`@akiojin/gwt` is a powerful CLI tool that revolutionizes Git worktree management through an intuitive interface. It seamlessly integrates with Claude Code / Codex CLI workflows, providing intelligent branch selection, automated worktree creation, and comprehensive project management capabilities.
+
+## ✨ Key Features
+
+- 🎯 **Modern React-based UI**: Built with Ink.js for a smooth, responsive terminal interface with real-time updates
+- 🖼️ **Full-screen Layout**: Persistent header with statistics, scrollable branch list, and always-visible footer with keyboard shortcuts
+- 🌟 **Smart Branch Creation**: Create feature, hotfix, or release branches with guided prompts and automatic base branch selection
+- 🔄 **Advanced Worktree Management**: Complete lifecycle management including creation, cleanup, and path optimization
+- 🤖 **AI Tool Selection**: Choose between Claude Code / Codex CLI through the interactive launcher
+- 🚀 **AI Tool Integration**: Launch the selected tool in the worktree (Claude Code includes permission handling and post-change flow)
+- 🔒 **Worktree Command Restriction**: PreToolUse hooks enforce worktree boundaries, blocking directory navigation, branch switching, and file operations outside the worktree
+- 📊 **GitHub PR Integration**: Automatic cleanup of merged pull request branches and worktrees
+- 🛠️ **Change Management**: Built-in support for committing, stashing, or discarding changes after development sessions
+- 📦 **Universal Package**: Install once, use across all your projects with consistent behavior
+- 🔍 **Real-time Statistics**: Live updates of branch and worktree counts with automatic terminal resize handling
+
+## Installation
+
+### Global Installation (Recommended)
+
+Install globally with your preferred package manager:
+
+#### bun (global install)
+
+```bash
+bun add -g @akiojin/gwt
+```
+
+### One-time Usage
+
+Run without installation using bunx:
+
+#### bunx (bun)
+
+```bash
+bunx @akiojin/gwt
+```
+
+## Quick Start
+
+Run in any Git repository:
+
+```bash
+# If installed globally
+gwt
+
+# Or use bunx for one-time execution
+bunx @akiojin/gwt
+```
+
+CLI options:
+
+```bash
+# Display help
+gwt --help
+
+# Check version
+gwt --version
+# or
+gwt -v
+```
+
+The tool presents an interactive interface with the following options:
+
+1. **Select Existing Branch**: Choose from local or remote branches with worktree auto-creation
+2. **Create New Branch**: Guided branch creation with type selection (feature/hotfix/release)
+3. **Manage Worktrees**: View, open, or remove existing worktrees
+4. **Cleanup Branches**: Remove merged PR branches or branches identical to their base directly from the CLI
+
+## Advanced Workflows
+
+### Branch Strategy
+
+This repository follows a structured branching strategy:
+
+- **`main`**: Production-ready code. Protected branch for releases only.
+- **`develop`**: Integration branch for features. All feature branches merge here.
+- **`feature/*`**: New features and enhancements. **Must be based on and target `develop`**.
+- **`hotfix/*`**: Critical production fixes. Based on and target `main`.
+- **`release/*`**: Release preparation branches.
+
+**Important**: When creating feature branches, always use `develop` as the base branch:
+
+```bash
+# Correct: Create feature branch from develop
+git checkout develop
+git pull origin develop
+git checkout -b feature/my-feature
+
+# Or use this tool which handles it automatically
+gwt
+# → Select "Create new branch" → "feature" → automatically uses develop as base
+```
+
+### Branch Creation Workflow
+
+> **Important**: This workflow is intended for human developers. Autonomous agents must never create or delete branches unless a human gives explicit, task-specific instructions.
+
+1. Select "Create new branch" from the main menu
+2. Choose branch type (feature, hotfix, release)
+3. Enter branch name with automatic prefix application
+4. Select base branch from available options (feature → develop, hotfix → main)
+5. Confirm worktree creation path
+6. Automatic worktree setup and selected tool launch
+
+### Worktree Management
+
+- **Open Existing**: Launch the selected tool in existing worktrees
+- **Remove Worktree**: Clean removal with optional branch deletion
+- **Batch Operations**: Handle multiple worktrees efficiently
+
+### GitHub Integration
+
+- **Branch Cleanup**: Automatically detect and remove merged pull request branches or branches that no longer differ from their base
+- **Authentication Check**: Verify GitHub CLI setup before operations
+- **Remote Sync**: Fetch latest changes before cleanup operations
+
+### Automated PR Merge
+
+The repository includes an automated PR merge workflow that streamlines the development process:
+
+- **Automatic Merge**: PRs are automatically merged when all CI checks (Test, Lint) pass and there are no conflicts
+- **Merge Method**: Uses merge commit to preserve full commit history
+- **Smart Skip Logic**: Automatically skips draft PRs, conflicted PRs, and failed CI runs
+- **Target Branch**: Active for PRs targeting `develop` branch (feature integration)
+- **Safety First**: Respects branch protection rules and requires successful CI completion
+
+**How it works:**
+
+1. PR is created targeting `develop`
+2. CI workflows (Test, Lint) run automatically
+3. When all CI checks pass and no conflicts exist, the PR is automatically merged to `develop`
+4. Changes accumulate on `develop` until ready for release
+5. Use `/release` command to merge `develop` to `main` and trigger semantic-release
+
+**Disabling auto-merge:**
+
+- Create PRs as drafts to prevent auto-merge: `gh pr create --draft`
+- The auto-merge workflow respects this setting and will skip draft PRs
+
+For technical details, see [specs/SPEC-cff08403/](specs/SPEC-cff08403/).
+
+## System Requirements
+
+- **Bun**: >= 1.0.0
+- **Node.js** (optional): Recommended >= 18.0.0 when working with Node-based tooling
+- **pnpm**: >= 8.0.0 (for CI/CD and Docker environments - uses hardlinked node_modules)
+- **Git**: Latest version with worktree support
+- **AI Tool**: At least one of Claude Code or Codex CLI should be available
+- **GitHub CLI**: Required for PR cleanup features (optional)
+- **Python**: >= 3.11 (for Spec Kit CLI)
+- **uv**: Python package manager (for Spec Kit CLI)
+
+## Spec-Driven Development with Spec Kit
+
+This project uses **@akiojin/spec-kit**, a Japanese-localized version of GitHub's Spec Kit for spec-driven development workflows.
+
+### Installing Spec Kit CLI
+
+```bash
+# Install globally with uv
+uv tool install specify-cli --from git+https://github.com/akiojin/spec-kit.git
+
+# Verify installation
+specify --help
+```
+
+### Available Spec Kit Commands
+
+Execute these commands in Claude Code to leverage spec-driven development:
+
+- `/speckit.constitution` - Define project principles and guidelines
+- `/speckit.specify` - Create feature specifications
+- `/speckit.plan` - Create technical implementation plans
+- `/speckit.tasks` - Generate actionable task lists
+- `/speckit.implement` - Execute implementation
+
+### Optional Quality Assurance Commands
+
+- `/speckit.clarify` - Resolve ambiguities before planning
+- `/speckit.analyze` - Validate consistency between spec, plan, and tasks
+- `/speckit.checklist` - Verify requirement coverage and clarity
+
+### Spec Kit Workflow
+
+1. Start with `/speckit.constitution` to establish project foundations
+2. Use `/speckit.specify` to define what you want to build
+3. Run `/speckit.plan` to create technical architecture
+4. Generate tasks with `/speckit.tasks`
+5. Implement with `/speckit.implement`
+
+For more details, see the [Spec Kit documentation](https://github.com/akiojin/spec-kit).
+
+## Project Structure
+
+```
+@akiojin/gwt/
+├── src/
+│   ├── index.ts          # Main application entry point
+│   ├── git.ts           # Git operations and branch management
+│   ├── worktree.ts      # Worktree creation and management
+│   ├── claude.ts        # Claude Code integration
+│   ├── codex.ts         # Codex CLI integration
+│   ├── github.ts        # GitHub CLI integration
+│   ├── utils.ts         # Utility functions and error handling
+│   └── ui/              # User interface components
+│       ├── display.ts   # Console output formatting
+│       ├── prompts.ts   # Interactive prompts
+│       ├── table.ts     # Branch table generation
+│       └── types.ts     # TypeScript type definitions
+├── bin/
+│   └── gwt.js # Executable wrapper
+├── .claude/             # Claude Code configuration
+│   ├── commands/        # Spec Kit slash commands
+│   ├── settings.json    # Hook configuration
+│   └── hooks/           # PreToolUse hooks for command restriction
+│       ├── block-cd-command.sh        # Restricts cd commands to worktree
+│       ├── block-git-branch-ops.sh    # Controls git branch operations
+│       └── block-file-ops.sh          # Restricts file operations to worktree
+├── .specify/            # Spec Kit scripts and templates
+│   ├── memory/          # Project memory files
+│   ├── scripts/         # Automation scripts
+│   └── templates/       # Specification templates
+├── specs/               # Feature specifications
+└── dist/                # Compiled JavaScript output
+```
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/akiojin/gwt.git
+cd gwt
+
+# Install dependencies (bun)
+bun install
+
+# Build the project (bun)
+bun run build
+```
+
+### Available Scripts
+
+```bash
+# Development mode with auto-rebuild (bun)
+bun run dev
+
+# Production build (bun)
+bun run build
+
+# Type checking (bun)
+bun run type-check
+
+# Code linting (bun)
+bun run lint
+
+# Clean build artifacts (bun)
+bun run clean
+
+# Test the CLI locally (bun)
+bun run start
+```
+
+### Development Workflow
+
+1. **Fork and Clone**: Fork the repository and clone your fork
+2. **Create Branch**: Use the tool itself to create a feature branch
+3. **Development**: Make changes with TypeScript support
+4. **Testing**: Test CLI functionality with `bun run start`
+5. **Quality Checks**: Run `bun run type-check` and `bun run lint`
+6. **Pull Request**: Submit a PR with clear description
+
+### Code Structure
+
+- **Entry Point**: `src/index.ts` - Main application logic
+- **Core Modules**: Git operations, worktree management, Claude integration
+- **UI Components**: Modular interface components in `src/ui/`
+- **Type Safety**: Comprehensive TypeScript definitions
+- **Error Handling**: Robust error management across all modules
+
+## Integration Examples
+
+### Custom Scripts
+
+```bash
+# Package.json script example
+{
+  "scripts": {
+    "worktree": "gwt"
+  }
+}
+```
+
+## Release Process
+
+We ship releases through semantic-release. End users can simply install the latest published package (via npm or the GitHub Releases tab) and rely on versioned artifacts. Maintainers who need the full workflow should read [docs/release-guide.md](./docs/release-guide.md) (日本語版: [docs/release-guide.ja.md](./docs/release-guide.ja.md)) and the in-depth specs under `specs/SPEC-57fde06f/`.
+
+## Troubleshooting
+
+### Common Issues
+
+**Permission Errors**: Ensure Claude Code has proper directory permissions
+**Git Worktree Conflicts**: Use the cleanup feature to remove stale worktrees
+**GitHub Authentication**: Run `gh auth login` before using PR cleanup features
+**Bun Version**: Verify Bun >= 1.0.0 with `bun --version`
+
+### Debug Mode
+
+For verbose output, set the environment variable:
+
+```bash
+DEBUG=gwt gwt
+```
+
+## License
+
+MIT - See LICENSE file for details
+
+## Contributing
+
+We welcome contributions! Please read our contributing guidelines:
+
+1. **Issues**: Report bugs or request features via GitHub Issues
+2. **Pull Requests**: Follow the development workflow above
+3. **Code Style**: Maintain TypeScript best practices and existing patterns
+4. **Documentation**: Update README and code comments for significant changes
+
+### Contributors
+
+- AI Novel Project Team
+- Community contributors welcome
+
+## Support
+
+- **Documentation**: This README and inline code documentation
+- **Issues**: GitHub Issues for bug reports and feature requests
+- **Discussions**: GitHub Discussions for questions and community support

package/bin/gwt.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/index.js').catch(err => {
+  console.error(err);
+  process.exit(1);
+});