agkan 2.14.3 → 3.0.1

package/README.ja.md

@@ -279,6 +279,60 @@ agkan task count --status in_progress
 agkan task count -s in_progress -q
 ```
 
+### カンバンボード (Web UI)
+
+ブラウザでローカルのカンバンボードビューアを起動:
+```bash
+agkan board
+```
+
+カスタムポートを指定:
+```bash
+agkan board -p 3000
+```
+
+デフォルトでは `http://localhost:8080` でボードが提供されます。
+
+#### ボードのClaude連携機能
+
+ボードUIにはブラウザから直接Claudeを実行するための機能が組み込まれています:
+
+- **Runボタン**: タスクカードにある「Run」ボタンをクリックすると、そのタスクに対して `claude` を起動します。ボタン横のドロップダウンからプランモードで実行することもできます。
+- **Planボタン**: タスクを実行せずに計画のみを生成するプランモードで `claude` を起動します。
+- **ストリームモーダル**: Claude実行中はモーダルウィンドウにリアルタイムで出力が表示されます。「Stop」ボタンでプロセスを終了できます。
+- **実行中インジケーター**: Claudeプロセスが動作中の場合、ヘッダーにインジケーターが表示されます。
+- **実行ログタブ**: タスク詳細パネルの「Run Logs」タブに、過去のClaude実行履歴（タイムスタンプと全出力）が表示されます。
+
+### Claudeプロセスの状態確認
+
+現在実行中のClaudeプロセスを一覧表示します（ボードサーバーが起動している必要があります）:
+```bash
+agkan ps
+```
+
+カスタムポートのボードサーバーに接続:
+```bash
+agkan ps --port 3000
+```
+
+このコマンドはボードサーバーに問い合わせて、現在実行中のClaudeプロセスとそれに関連するタスクを表示します。
+
+JSON出力フォーマット:
+```bash
+agkan ps --json
+```
+```json
+{
+  "processes": [
+    {
+      "taskId": 42,
+      "title": "機能Xの実装",
+      "command": "claude"
+    }
+  ]
+}
+```
+
 ### ヘルプの表示
 
 コマンド一覧:
@@ -298,7 +352,7 @@ agkan task add --help
 
 ## JSON出力フォーマット
 
-agkanは9つのデータ取得・表示コマンドで、機械可読なJSON出力をサポートしています。`--json`フラグを追加することで、人間が読みやすいテキストの代わりに構造化されたデータを出力できます。
+agkanは10のデータ取得・表示コマンドで、機械可読なJSON出力をサポートしています。`--json`フラグを追加することで、人間が読みやすいテキストの代わりに構造化されたデータを出力できます。
 
 ### 対応コマンド
 
@@ -314,6 +368,7 @@ agkanは9つのデータ取得・表示コマンドで、機械可読なJSON出
 - `task tag list` - 全タグをタスク数と共に一覧表示
 - `task tag show` - 特定のタスクのタグを表示
 - `task meta list` - タスクのメタデータ一覧を表示
+- `ps` - 現在実行中のClaudeプロセスを一覧表示
 
 ### 出力構造
 
@@ -820,11 +875,11 @@ export AGENT_KANBAN_DB_PATH=./dev/data.db      # 開発環境
 export AGENT_KANBAN_DB_PATH=./staging/data.db  # ステージング環境
 
 # テストの実行
-NODE_ENV=test npm test
+NODE_ENV=test pnpm test
 # デフォルトで .agkan-test/data.db を使用
 
 # カスタムテストDBで実行
-NODE_ENV=test AGENT_KANBAN_DB_PATH=/tmp/test.db npm test
+NODE_ENV=test AGENT_KANBAN_DB_PATH=/tmp/test.db pnpm test
 ```
 
 #### デフォルトの動作
@@ -921,246 +976,15 @@ board:
 
 ## プロジェクト構成
 
-```
-agkan/
-├── bin/
-│   └── agkan                        # CLIエントリーポイント
-├── src/
-│   ├── cli/
-│   │   ├── commands/
-│   │   │   ├── block/               # ブロック関係コマンド
-│   │   │   │   ├── add.ts
-│   │   │   │   ├── list.ts
-│   │   │   │   └── remove.ts
-│   │   │   ├── meta/                # メタデータコマンド
-│   │   │   │   ├── delete.ts
-│   │   │   │   ├── get.ts
-│   │   │   │   ├── list.ts
-│   │   │   │   └── set.ts
-│   │   │   ├── tag/                 # タグコマンド
-│   │   │   │   ├── add.ts
-│   │   │   │   ├── attach.ts
-│   │   │   │   ├── delete.ts
-│   │   │   │   ├── detach.ts
-│   │   │   │   ├── list.ts
-│   │   │   │   └── show.ts
-│   │   │   └── task/                # タスクコマンド
-│   │   │       ├── add.ts
-│   │   │       ├── count.ts
-│   │   │       ├── delete.ts
-│   │   │       ├── find.ts
-│   │   │       ├── get.ts
-│   │   │       ├── list.ts
-│   │   │       ├── update-parent.ts
-│   │   │       └── update.ts
-│   │   ├── utils/                   # CLIユーティリティ
-│   │   └── index.ts                 # CLIエントリー・コマンド登録
-│   ├── db/
-│   │   ├── config.ts                # DB設定
-│   │   ├── connection.ts            # データベース接続管理
-│   │   ├── schema.ts                # スキーマ定義・マイグレーション
-│   │   └── reset.ts                 # テスト用DBリセット
-│   ├── models/
-│   │   ├── Task.ts                  # タスクモデル
-│   │   ├── Tag.ts                   # タグモデル
-│   │   ├── TaskBlock.ts             # ブロック関係モデル
-│   │   ├── TaskMetadata.ts          # メタデータモデル
-│   │   ├── TaskTag.ts               # タスク-タグ関連モデル
-│   │   └── index.ts
-│   ├── services/
-│   │   ├── TaskService.ts           # タスク管理ビジネスロジック
-│   │   ├── TagService.ts            # タグ管理ビジネスロジック
-│   │   ├── TaskBlockService.ts      # ブロック関係管理
-│   │   ├── TaskTagService.ts        # タスク-タグ関連管理
-│   │   ├── MetadataService.ts       # メタデータ管理
-│   │   ├── FileService.ts           # ファイル読み込み
-│   │   └── index.ts
-│   └── utils/
-│       ├── format.ts                # フォーマットユーティリティ
-│       ├── cycle-detector.ts        # 循環参照検出
-│       ├── input-validators.ts      # 入力バリデーション
-│       └── security.ts              # セキュリティユーティリティ
-├── dist/                            # ビルド出力ディレクトリ
-├── package.json
-├── tsconfig.json
-└── README.md
-```
+詳細なディレクトリ構成は [docs/project-structure.ja.md](docs/project-structure.ja.md) を参照してください。
 
 ## データベーススキーマ
 
-### tasks テーブル
-
-| カラム名 | 型 | 説明 |
-|---------|-----|------|
-| id | INTEGER | 主キー（自動採番） |
-| title | TEXT | タスクタイトル（必須） |
-| body | TEXT | タスク本文 |
-| status | TEXT | ステータス（icebox, backlog, ready, in_progress, review, done, closed） |
-| author | TEXT | 作成者 |
-| parent_id | INTEGER | 親タスクID（外部キー、NULL可） |
-| created_at | TEXT | 作成日時（ISO 8601形式） |
-| updated_at | TEXT | 更新日時（ISO 8601形式） |
-
-注意事項:
-- `parent_id`は親タスクが削除されると自動的にNULLに設定されます（ON DELETE SET NULL）
-
-### attachments テーブル
-
-| カラム名 | 型 | 説明 |
-|---------|-----|------|
-| id | INTEGER | 主キー（自動採番） |
-| task_id | INTEGER | タスクID（外部キー） |
-| file_path | TEXT | ファイルパス（必須） |
-| created_at | TEXT | 作成日時（ISO 8601形式） |
-
-### task_blocks テーブル
-
-| カラム名 | 型 | 説明 |
-|---------|-----|------|
-| id | INTEGER | 主キー（自動採番） |
-| blocker_task_id | INTEGER | ブロックするタスクID（外部キー） |
-| blocked_task_id | INTEGER | ブロックされるタスクID（外部キー） |
-| created_at | TEXT | 作成日時（ISO 8601形式） |
-
-注意事項:
-- `blocker_task_id`と`blocked_task_id`の組み合わせはユニーク制約があります
-- いずれかのタスクが削除されるとブロック関係も自動的に削除されます（ON DELETE CASCADE）
-
-### tags テーブル
-
-| カラム名 | 型 | 説明 |
-|---------|-----|------|
-| id | INTEGER | 主キー（自動採番） |
-| name | TEXT | タグ名（必須、ユニーク） |
-| created_at | TEXT | 作成日時（ISO 8601形式） |
-
-### task_tags テーブル
-
-| カラム名 | 型 | 説明 |
-|---------|-----|------|
-| id | INTEGER | 主キー（自動採番） |
-| task_id | INTEGER | タスクID（外部キー） |
-| tag_id | INTEGER | タグID（外部キー） |
-| created_at | TEXT | 作成日時（ISO 8601形式） |
-
-注意事項:
-- `task_id`と`tag_id`の組み合わせはユニーク制約があります
-- タスクまたはタグが削除されると関連付けも自動的に削除されます（ON DELETE CASCADE）
-
-### task_metadata テーブル
-
-| カラム名 | 型 | 説明 |
-|---------|-----|------|
-| id | INTEGER | 主キー（自動採番） |
-| task_id | INTEGER | タスクID（外部キー） |
-| key | TEXT | メタデータのキー |
-| value | TEXT | メタデータの値 |
-| created_at | TEXT | 作成日時（ISO 8601形式） |
-
-注意事項:
-- `task_id`と`key`の組み合わせはユニーク制約があります
-- タスクが削除されるとメタデータも自動的に削除されます（ON DELETE CASCADE）
+詳細なスキーマ情報は [docs/database-schema.ja.md](docs/database-schema.ja.md) を参照してください。
 
 ## 開発
 
-### 開発者向けセットアップ
-
-agkan自体の開発に参加したい開発者向けの手順:
-
-1. リポジトリをクローン:
-```bash
-git clone https://github.com/gendosu/agkan.git
-cd agkan
-```
-
-2. 依存パッケージをインストール:
-```bash
-npm install
-```
-
-3. TypeScriptコードをビルド:
-```bash
-npm run build
-```
-
-4. グローバルコマンドとして登録:
-```bash
-npm link
-```
-
-### 開発ガイドライン
-
-包括的な開発情報については、以下のドキュメントを参照してください:
-
-- **[TESTING.md](TESTING.md)** - テストガイド、カバレッジ実行、テストパターン
-- **[CONTRIBUTING.md](CONTRIBUTING.md)** - コントリビューションガイドラインとTDDプラクティス
-- **[docs/TDD-GUIDE.md](docs/TDD-GUIDE.md)** - 実践例を含むテスト駆動開発ガイド
-- **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - プロジェクトアーキテクチャとデザインパターン
-
-### コード品質
-
-このプロジェクトではコード品質のためにESLintとPrettierを使用しています:
-
-```bash
-npm run lint        # コードをチェック
-npm run lint:fix    # 問題を自動修正
-npm run format      # コードをフォーマット
-npm run check       # 全チェックを実行
-```
-
-### テスト
-
-#### ユニットテスト
-
-Vitestを使用したユニットテストを実行:
-```bash
-npm test
-```
-
-全てのサービス層とモデル層がテストされています。
-
-#### E2Eテスト
-
-実際のCLIコマンドを実行する包括的なE2Eテストを実行:
-```bash
-npm run test:e2e
-```
-
-E2Eテストは以下の機能をカバーします:
-- ビルドとユニットテスト
-- タグ管理機能（作成、一覧、削除、重複チェック）
-- タグ付与機能（付与、解除、表示、重複チェック）
-- タグフィルタリング（単一タグ、複数タグ、ステータス組み合わせ）
-- CASCADE削除（データベース整合性確認）
-
-テストはローカルのテスト用データベース（`.agkan-test/test-e2e.db`）を使用し、実行後に自動的にクリーンアップされます。
-
-### ビルド
-
-```bash
-npm run build
-```
-
-### 開発時の自動ビルド
-
-```bash
-npm run dev
-```
-
-### TypeScript型チェック
-
-```bash
-npx tsc --noEmit
-```
-
-### データベースの初期化
-
-データベースは最初のコマンド実行時に自動的に作成されます。手動で再作成する場合:
-
-```bash
-rm -rf data/agkan.db
-agkan task list  # データベースが再作成されます
-```
+セットアップ手順、テスト、ビルド情報については [docs/development.ja.md](docs/development.ja.md) を参照してください。
 
 ## ライセンス
 
@@ -1168,4 +992,4 @@ ISC
 
 ## 作成者
 
-Generated with Claude Code
+GENDOSU

package/README.md

@@ -534,6 +534,46 @@ agkan board -p 3000
 
 The board is served at `http://localhost:8080` by default.
 
+#### Claude Integration in the Board
+
+The board UI includes built-in Claude integration for running tasks directly from the browser:
+
+- **Run button**: Each task card has a "Run" button that launches `claude` for that task. A dropdown arrow next to the button also allows running in plan mode.
+- **Plan button**: Runs `claude` in plan mode to generate a plan for the task without executing.
+- **Stream modal**: When Claude is running, a modal window displays the live output stream in real time. A "Stop" button allows terminating the process.
+- **Running indicator**: A header indicator shows when any Claude process is currently active.
+- **Run Logs tab**: The task detail panel includes a "Run Logs" tab that shows the history of all past Claude executions for that task, with timestamps and full output.
+
+### Claude Process Status
+
+List currently executing Claude processes (requires the board server to be running):
+```bash
+agkan ps
+```
+
+Connect to a board server on a custom port:
+```bash
+agkan ps --port 3000
+```
+
+This command queries the board server to show which Claude processes are currently running and which tasks they are associated with.
+
+JSON output format:
+```bash
+agkan ps --json
+```
+```json
+{
+  "processes": [
+    {
+      "taskId": 42,
+      "title": "Implement feature X",
+      "command": "claude"
+    }
+  ]
+}
+```
+
 ### Display Help
 
 Show command list:
@@ -553,7 +593,7 @@ agkan task add --help
 
 ## JSON Output Format
 
-agkan supports machine-readable JSON output for 9 data retrieval and display commands. Add the `--json` flag to output structured data instead of human-readable text.
+agkan supports machine-readable JSON output for 10 data retrieval and display commands. Add the `--json` flag to output structured data instead of human-readable text.
 
 ### Supported Commands
 
@@ -569,6 +609,7 @@ The following commands support JSON output:
 - `task tag list` - List all tags with task counts
 - `task tag show` - Show tags for a specific task
 - `task meta list` - List all metadata for a task
+- `ps` - List currently executing Claude processes
 
 ### Output Structure
 
@@ -848,11 +889,11 @@ Test mode (`NODE_ENV=test`) automatically isolates test data from production dat
 3. **Testing:**
    ```bash
    # Automated tests with isolated database
-   NODE_ENV=test npm test
+   NODE_ENV=test pnpm test
    # Uses .agkan-test/data.db by default
 
    # Override with custom test database
-   NODE_ENV=test AGENT_KANBAN_DB_PATH=/tmp/test.db npm test
+   NODE_ENV=test AGENT_KANBAN_DB_PATH=/tmp/test.db pnpm test
    ```
 
 #### Default Behavior
@@ -950,249 +991,15 @@ For detailed information about planned features, see [docs/planned-features.md](
 
 ## Project Structure
 
-```
-agkan/
-├── bin/
-│   └── agkan                        # CLI entry point
-├── src/
-│   ├── cli/
-│   │   ├── commands/
-│   │   │   ├── block/               # Blocking relationship commands
-│   │   │   │   ├── add.ts
-│   │   │   │   ├── list.ts
-│   │   │   │   └── remove.ts
-│   │   │   ├── meta/                # Metadata commands
-│   │   │   │   ├── delete.ts
-│   │   │   │   ├── get.ts
-│   │   │   │   ├── list.ts
-│   │   │   │   └── set.ts
-│   │   │   ├── tag/                 # Tag commands
-│   │   │   │   ├── add.ts
-│   │   │   │   ├── attach.ts
-│   │   │   │   ├── delete.ts
-│   │   │   │   ├── detach.ts
-│   │   │   │   ├── list.ts
-│   │   │   │   └── show.ts
-│   │   │   ├── board.ts             # Kanban board command
-│   │   │   └── task/                # Task commands
-│   │   │       ├── add.ts
-│   │   │       ├── count.ts
-│   │   │       ├── delete.ts
-│   │   │       ├── find.ts
-│   │   │       ├── get.ts
-│   │   │       ├── list.ts
-│   │   │       ├── update-parent.ts
-│   │   │       └── update.ts
-│   │   ├── utils/                   # CLI utilities
-│   │   └── index.ts                 # CLI entry point and command registration
-│   ├── board/
-│   │   └── server.ts                # Kanban board web server (Hono)
-│   ├── db/
-│   │   ├── config.ts                # DB configuration
-│   │   ├── connection.ts            # Database connection management
-│   │   ├── schema.ts                # Schema definition and migration
-│   │   └── reset.ts                 # DB reset for testing
-│   ├── models/
-│   │   ├── Task.ts                  # Task model
-│   │   ├── Tag.ts                   # Tag model
-│   │   ├── TaskBlock.ts             # Blocking relationship model
-│   │   ├── TaskMetadata.ts          # Metadata model
-│   │   ├── TaskTag.ts               # Task-tag association model
-│   │   └── index.ts
-│   ├── services/
-│   │   ├── TaskService.ts           # Task management business logic
-│   │   ├── TagService.ts            # Tag management business logic
-│   │   ├── TaskBlockService.ts      # Blocking relationship management
-│   │   ├── TaskTagService.ts        # Task-tag association management
-│   │   ├── MetadataService.ts       # Metadata management
-│   │   ├── FileService.ts           # File reading
-│   │   └── index.ts
-│   └── utils/
-│       ├── format.ts                # Format utilities
-│       ├── cycle-detector.ts        # Circular reference detection
-│       ├── input-validators.ts      # Input validation
-│       └── security.ts              # Security utilities
-├── dist/                            # Build output directory
-├── package.json
-├── tsconfig.json
-└── README.md
-```
+See [docs/project-structure.md](docs/project-structure.md) for the full directory layout.
 
 ## Database Schema
 
-### tasks Table
-
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | INTEGER | Primary key (auto-increment) |
-| title | TEXT | Task title (required) |
-| body | TEXT | Task body |
-| status | TEXT | Status (icebox, backlog, ready, in_progress, review, done, closed) |
-| author | TEXT | Creator/author |
-| parent_id | INTEGER | Parent task ID (foreign key, nullable) |
-| created_at | TEXT | Creation timestamp (ISO 8601 format) |
-| updated_at | TEXT | Update timestamp (ISO 8601 format) |
-
-Notes:
-- `parent_id` is automatically set to NULL when parent task is deleted (ON DELETE SET NULL)
-
-### attachments Table
-
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | INTEGER | Primary key (auto-increment) |
-| task_id | INTEGER | Task ID (foreign key) |
-| file_path | TEXT | File path (required) |
-| created_at | TEXT | Creation timestamp (ISO 8601 format) |
-
-### task_blocks Table
-
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | INTEGER | Primary key (auto-increment) |
-| blocker_task_id | INTEGER | Task ID that blocks (foreign key) |
-| blocked_task_id | INTEGER | Task ID that is blocked (foreign key) |
-| created_at | TEXT | Creation timestamp (ISO 8601 format) |
-
-Notes:
-- `blocker_task_id` and `blocked_task_id` combination has a unique constraint
-- Blocking relationships are automatically deleted when either task is deleted (ON DELETE CASCADE)
-
-### tags Table
-
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | INTEGER | Primary key (auto-increment) |
-| name | TEXT | Tag name (required, unique) |
-| created_at | TEXT | Creation timestamp (ISO 8601 format) |
-
-### task_tags Table
-
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | INTEGER | Primary key (auto-increment) |
-| task_id | INTEGER | Task ID (foreign key) |
-| tag_id | INTEGER | Tag ID (foreign key) |
-| created_at | TEXT | Creation timestamp (ISO 8601 format) |
-
-Notes:
-- `task_id` and `tag_id` combination has a unique constraint
-- Associations are automatically deleted when task or tag is deleted (ON DELETE CASCADE)
-
-### task_metadata Table
-
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | INTEGER | Primary key (auto-increment) |
-| task_id | INTEGER | Task ID (foreign key) |
-| key | TEXT | Metadata key |
-| value | TEXT | Metadata value |
-| created_at | TEXT | Creation timestamp (ISO 8601 format) |
-
-Notes:
-- `task_id` and `key` combination has a unique constraint
-- Metadata is automatically deleted when the task is deleted (ON DELETE CASCADE)
+See [docs/database-schema.md](docs/database-schema.md) for the full schema reference.
 
 ## Development
 
-### Developer Setup
-
-For contributors and developers who want to work on agkan itself:
-
-1. Clone the repository:
-```bash
-git clone https://github.com/gendosu/agkan.git
-cd agkan
-```
-
-2. Install dependencies:
-```bash
-npm install
-```
-
-3. Build the TypeScript code:
-```bash
-npm run build
-```
-
-4. Register as a global command:
-```bash
-npm link
-```
-
-### Development Guidelines
-
-For comprehensive development information, see the following documentation:
-
-- **[TESTING.md](TESTING.md)** - Testing guide, coverage execution, and test patterns
-- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guidelines and TDD practices
-- **[docs/TDD-GUIDE.md](docs/TDD-GUIDE.md)** - Test-Driven Development guide with practical examples
-- **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - Project architecture and design patterns
-
-### Code Quality
-
-This project uses ESLint and Prettier for code quality:
-
-```bash
-npm run lint        # Check code
-npm run lint:fix    # Auto-fix issues
-npm run format      # Format code
-npm run check       # Run all checks
-```
-
-### Testing
-
-#### Unit Tests
-
-Run unit tests with Vitest:
-```bash
-npm test
-```
-
-All service and model layers are tested.
-
-#### End-to-End Tests
-
-Run comprehensive e2e tests that execute actual CLI commands:
-```bash
-npm run test:e2e
-```
-
-E2E tests cover the following features:
-- Build and unit tests
-- Tag management (create, list, delete, duplicate check)
-- Tag assignment (attach, detach, display, duplicate check)
-- Tag filtering (single tag, multiple tags, status combinations)
-- CASCADE delete (database integrity verification)
-
-Tests use a local test database (`.agkan-test/test-e2e.db`) and are automatically cleaned up after execution.
-
-### Build
-
-```bash
-npm run build
-```
-
-### Auto-build During Development
-
-```bash
-npm run dev
-```
-
-### TypeScript Type Checking
-
-```bash
-npx tsc --noEmit
-```
-
-### Initialize Database
-
-The database is automatically created on first command execution. To manually recreate:
-
-```bash
-rm -rf data/agkan.db
-agkan task list  # Database will be recreated
-```
+See [docs/development.md](docs/development.md) for setup instructions, testing, and build information.
 
 ## License
 
@@ -1200,4 +1007,4 @@ ISC
 
 ## Author
 
-Generated with Claude Code
+GENDOSU