agkan 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 gendosu <gendosu@gmail.com>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.ja.md

@@ -9,7 +9,7 @@ TypeScriptで実装された軽量なCLIタスク管理ツールです。エー
 
 - **シンプルなCLI**: 直感的なコマンドラインインターフェース
 - **SQLiteベース**: ローカルでの高速データ管理
-- **カンバン形式**: 6つのステータスでタスクを管理（backlog, ready, in_progress, review, done, closed）
+- **カンバン形式**: 7つのステータスでタスクを管理（icebox, backlog, ready, in_progress, review, done, closed）
 - **柔軟な入力**: コマンドライン引数またはMarkdownファイルからタスクを作成
 - **フィルタリング**: ステータスや作成者でタスクを絞り込み
 - **色分け表示**: ステータスごとに見やすい色分け表示
@@ -40,129 +40,6 @@ npm install -g agkan
 npm install -g https://github.com/gendosu/agkan.git
 ```
 
-## 設定
-
-### データベースの保存場所
-
-agkanは、データベースの保存場所を設定ファイルでカスタマイズできます。
-
-#### 設定ファイル: `.agkan.yml`
-
-プロジェクトのルートディレクトリに`.agkan.yml`ファイルを作成することで、データベースの保存場所を指定できます。
-
-**設定例:**
-
-```yaml
-# データベースファイルのパス
-path: ./.agkan/data.db
-```
-
-#### パスの指定方法
-
-- **相対パス**: カレントディレクトリからの相対パスとして解決されます
-  ```yaml
-  path: ./data/kanban.db
-  path: ./.agkan/data.db
-  ```
-
-- **絶対パス**: そのままのパスが使用されます
-  ```yaml
-  path: /home/user/.config/agkan/data.db
-  ```
-
-#### 環境変数による設定
-
-agkanは `AGENT_KANBAN_DB_PATH` 環境変数によるデータベースの場所指定をサポートしています。CI/CD環境や複数環境の管理に特に有用です。
-
-**環境変数の設定例:**
-
-```bash
-# カスタムデータベースパスを使用
-export AGENT_KANBAN_DB_PATH=/path/to/your/database.db
-agkan task list
-
-# 絶対パスを使用
-export AGENT_KANBAN_DB_PATH=/home/user/.config/agkan/data.db
-
-# 相対パスを使用
-export AGENT_KANBAN_DB_PATH=./custom/location/data.db
-```
-
-**優先順位:**
-
-データベースパスは以下の優先順位で解決されます:
-
-**通常モード (`NODE_ENV` が `test` でない場合):**
-1. **環境変数**（最高優先）: `AGENT_KANBAN_DB_PATH`
-2. **設定ファイル**（フォールバック）: `.agkan.yml` の `path` フィールド
-3. **デフォルトパス**（最低優先）: `.agkan/data.db`
-
-**テストモード (`NODE_ENV=test` の場合):**
-1. **環境変数**（最高優先）: `AGENT_KANBAN_DB_PATH`
-2. **設定ファイル**（フォールバック）: `.agkan-test.yml` の `path` フィールド
-3. **デフォルトパス**（最低優先）: `.agkan-test/data.db`
-
-**テストモードについて:**
-
-テストモード（`NODE_ENV=test`）では、テストデータと本番データを自動的に分離します:
-
-- 別の設定ファイルを使用: `.agkan.yml` の代わりに `.agkan-test.yml`
-- 別のデフォルトディレクトリを使用: `.agkan/` の代わりに `.agkan-test/`
-- テストモードでも環境変数が最高優先になります
-
-**使用例:**
-
-```bash
-# CI/CDパイプライン（一時DBを使用）
-export AGENT_KANBAN_DB_PATH=/tmp/ci-test-db.db
-agkan task list
-
-# 複数環境の管理
-export AGENT_KANBAN_DB_PATH=./dev/data.db      # 開発環境
-export AGENT_KANBAN_DB_PATH=./staging/data.db  # ステージング環境
-
-# テストの実行
-NODE_ENV=test npm test
-# デフォルトで .agkan-test/data.db を使用
-
-# カスタムテストDBで実行
-NODE_ENV=test AGENT_KANBAN_DB_PATH=/tmp/test.db npm test
-```
-
-#### デフォルトの動作
-
-`.agkan.yml`ファイルが存在せず、環境変数も設定されていない場合、データベースは以下の場所に作成されます：
-
-```
-<カレントディレクトリ>/.agkan/data.db
-```
-
-テストモード（`NODE_ENV=test`）の場合のデフォルト:
-
-```
-<カレントディレクトリ>/.agkan-test/data.db
-```
-
-#### プロジェクトごとの管理
-
-プロジェクトごとに異なるタスク管理を行いたい場合は、各プロジェクトのルートに`.agkan.yml`を配置してください：
-
-```bash
-# プロジェクトA
-cd /path/to/projectA
-cat > .agkan.yml << EOF
-path: ./.agkan/data.db
-EOF
-
-# プロジェクトB
-cd /path/to/projectB
-cat > .agkan.yml << EOF
-path: ./.agkan/data.db
-EOF
-```
-
-これにより、各プロジェクトで独立したタスク管理が可能になります。
-
 ## 使用方法
 
 ### タスクの作成
@@ -847,6 +724,7 @@ agkan task tag delete "urgent"
 
 ## タスクステータス
 
+- **icebox**: 積極的に検討していない凍結タスク（白色表示）
 - **backlog**: 未着手のタスク（グレー表示）
 - **ready**: 着手可能なタスク（青色表示）
 - **in_progress**: 作業中のタスク（黄色表示）
@@ -854,6 +732,129 @@ agkan task tag delete "urgent"
 - **done**: 完了したタスク（緑色表示）
 - **closed**: クローズされたタスク（マゼンタ表示）
 
+## 設定
+
+### データベースの保存場所
+
+agkanは、データベースの保存場所を設定ファイルでカスタマイズできます。
+
+#### 設定ファイル: `.agkan.yml`
+
+プロジェクトのルートディレクトリに`.agkan.yml`ファイルを作成することで、データベースの保存場所を指定できます。
+
+**設定例:**
+
+```yaml
+# データベースファイルのパス
+path: ./.agkan/data.db
+```
+
+#### パスの指定方法
+
+- **相対パス**: カレントディレクトリからの相対パスとして解決されます
+  ```yaml
+  path: ./data/kanban.db
+  path: ./.agkan/data.db
+  ```
+
+- **絶対パス**: そのままのパスが使用されます
+  ```yaml
+  path: /home/user/.config/agkan/data.db
+  ```
+
+#### 環境変数による設定
+
+agkanは `AGENT_KANBAN_DB_PATH` 環境変数によるデータベースの場所指定をサポートしています。CI/CD環境や複数環境の管理に特に有用です。
+
+**環境変数の設定例:**
+
+```bash
+# カスタムデータベースパスを使用
+export AGENT_KANBAN_DB_PATH=/path/to/your/database.db
+agkan task list
+
+# 絶対パスを使用
+export AGENT_KANBAN_DB_PATH=/home/user/.config/agkan/data.db
+
+# 相対パスを使用
+export AGENT_KANBAN_DB_PATH=./custom/location/data.db
+```
+
+**優先順位:**
+
+データベースパスは以下の優先順位で解決されます:
+
+**通常モード (`NODE_ENV` が `test` でない場合):**
+1. **環境変数**（最高優先）: `AGENT_KANBAN_DB_PATH`
+2. **設定ファイル**（フォールバック）: `.agkan.yml` の `path` フィールド
+3. **デフォルトパス**（最低優先）: `.agkan/data.db`
+
+**テストモード (`NODE_ENV=test` の場合):**
+1. **環境変数**（最高優先）: `AGENT_KANBAN_DB_PATH`
+2. **設定ファイル**（フォールバック）: `.agkan-test.yml` の `path` フィールド
+3. **デフォルトパス**（最低優先）: `.agkan-test/data.db`
+
+**テストモードについて:**
+
+テストモード（`NODE_ENV=test`）では、テストデータと本番データを自動的に分離します:
+
+- 別の設定ファイルを使用: `.agkan.yml` の代わりに `.agkan-test.yml`
+- 別のデフォルトディレクトリを使用: `.agkan/` の代わりに `.agkan-test/`
+- テストモードでも環境変数が最高優先になります
+
+**使用例:**
+
+```bash
+# CI/CDパイプライン（一時DBを使用）
+export AGENT_KANBAN_DB_PATH=/tmp/ci-test-db.db
+agkan task list
+
+# 複数環境の管理
+export AGENT_KANBAN_DB_PATH=./dev/data.db      # 開発環境
+export AGENT_KANBAN_DB_PATH=./staging/data.db  # ステージング環境
+
+# テストの実行
+NODE_ENV=test npm test
+# デフォルトで .agkan-test/data.db を使用
+
+# カスタムテストDBで実行
+NODE_ENV=test AGENT_KANBAN_DB_PATH=/tmp/test.db npm test
+```
+
+#### デフォルトの動作
+
+`.agkan.yml`ファイルが存在せず、環境変数も設定されていない場合、データベースは以下の場所に作成されます：
+
+```
+<カレントディレクトリ>/.agkan/data.db
+```
+
+テストモード（`NODE_ENV=test`）の場合のデフォルト:
+
+```
+<カレントディレクトリ>/.agkan-test/data.db
+```
+
+#### プロジェクトごとの管理
+
+プロジェクトごとに異なるタスク管理を行いたい場合は、各プロジェクトのルートに`.agkan.yml`を配置してください：
+
+```bash
+# プロジェクトA
+cd /path/to/projectA
+cat > .agkan.yml << EOF
+path: ./.agkan/data.db
+EOF
+
+# プロジェクトB
+cd /path/to/projectB
+cat > .agkan.yml << EOF
+path: ./.agkan/data.db
+EOF
+```
+
+これにより、各プロジェクトで独立したタスク管理が可能になります。
+
 ## 実装予定機能
 
 ### タスクの添付ファイル
@@ -951,7 +952,7 @@ agkan/
 | id | INTEGER | 主キー（自動採番） |
 | title | TEXT | タスクタイトル（必須） |
 | body | TEXT | タスク本文 |
-| status | TEXT | ステータス（backlog, ready, in_progress, review, done, closed） |
+| status | TEXT | ステータス（icebox, backlog, ready, in_progress, review, done, closed） |
 | author | TEXT | 作成者 |
 | parent_id | INTEGER | 親タスクID（外部キー、NULL可） |
 | created_at | TEXT | 作成日時（ISO 8601形式） |

package/README.md

@@ -9,7 +9,7 @@ A lightweight CLI task management tool implemented in TypeScript. Optimized for
 
 - **Simple CLI**: Intuitive command-line interface
 - **SQLite-based**: Fast local data management
-- **Kanban Format**: Manage tasks with 6 statuses (backlog, ready, in_progress, review, done, closed)
+- **Kanban Format**: Manage tasks with 7 statuses (icebox, backlog, ready, in_progress, review, done, closed)
 - **Flexible Input**: Create tasks from command-line arguments or Markdown files
 - **Filtering**: Narrow down tasks by status or author
 - **Color-coded Display**: Easy-to-read color-coded display by status
@@ -40,142 +40,6 @@ Install directly from the repository:
 npm install -g https://github.com/gendosu/agkan.git
 ```
 
-## Configuration
-
-### Database Storage Location
-
-agkan allows customization of the database storage location via a configuration file.
-
-#### Configuration File: `.agkan.yml`
-
-Create a `.agkan.yml` file in your project root directory to specify the database storage location.
-
-**Configuration Example:**
-
-```yaml
-# Path to database file
-path: ./.agkan/data.db
-```
-
-#### Path Specification
-
-- **Relative Path**: Resolved relative to the current directory
-  ```yaml
-  path: ./data/kanban.db
-  path: ./.agkan/data.db
-  ```
-
-- **Absolute Path**: Used as-is
-  ```yaml
-  path: /home/user/.config/akan/data.db
-  ```
-
-#### Environment Variable Configuration
-
-agkan supports the `AGENT_KANBAN_DB_PATH` environment variable for specifying the database location. This is particularly useful in CI/CD environments and for managing multiple environments.
-
-**Setting the Environment Variable:**
-
-```bash
-# Use a custom database path
-export AGENT_KANBAN_DB_PATH=/path/to/your/database.db
-agkan task list
-
-# Use absolute path
-export AGENT_KANBAN_DB_PATH=/home/user/.config/akan/data.db
-
-# Use relative path
-export AGENT_KANBAN_DB_PATH=./custom/location/data.db
-```
-
-**Priority Order:**
-
-The database path is resolved in the following priority order:
-
-**Normal Mode (when `NODE_ENV` is not `test`):**
-1. **Environment Variable** (highest priority): `AGENT_KANBAN_DB_PATH`
-2. **Configuration File** (fallback): `path` field in `.agkan.yml`
-3. **Default Path** (lowest priority): `.agkan/data.db`
-
-**Test Mode (when `NODE_ENV=test`):**
-1. **Environment Variable** (highest priority): `AGENT_KANBAN_DB_PATH`
-2. **Configuration File** (fallback): `path` field in `.agkan-test.yml`
-3. **Default Path** (lowest priority): `.agkan-test/data.db`
-
-**Test Mode Explanation:**
-
-Test mode (`NODE_ENV=test`) automatically isolates test data from production data:
-
-- Uses separate configuration file: `.agkan-test.yml` instead of `.agkan.yml`
-- Uses separate default directory: `.agkan-test/` instead of `.agkan/`
-- Environment variable still takes highest priority in test mode
-- Prevents accidental mixing of test and production data
-
-**Use Cases:**
-
-1. **CI/CD Pipeline:**
-   ```bash
-   # Use temporary database for CI tests
-   export AGENT_KANBAN_DB_PATH=/tmp/ci-test-db.db
-   agkan task list
-   ```
-
-2. **Multiple Environments:**
-   ```bash
-   # Development environment
-   export AGENT_KANBAN_DB_PATH=./dev/data.db
-
-   # Staging environment
-   export AGENT_KANBAN_DB_PATH=./staging/data.db
-
-   # Production environment
-   export AGENT_KANBAN_DB_PATH=./prod/data.db
-   ```
-
-3. **Testing:**
-   ```bash
-   # Automated tests with isolated database
-   NODE_ENV=test npm 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
-   ```
-
-#### Default Behavior
-
-If no `.agkan.yml` file exists and no environment variable is set, the database is created in:
-
-```
-<current-directory>/.agkan/data.db
-```
-
-In test mode (`NODE_ENV=test`), the default location is:
-
-```
-<current-directory>/.agkan-test/data.db
-```
-
-#### Per-Project Management
-
-To manage separate tasks for different projects, place `.agkan.yml` in each project root:
-
-```bash
-# Project A
-cd /path/to/projectA
-cat > .agkan.yml << EOF
-path: ./.agkan/data.db
-EOF
-
-# Project B
-cd /path/to/projectB
-cat > .agkan.yml << EOF
-path: ./.agkan/data.db
-EOF
-```
-
-This enables independent task management for each project.
-
 ## Usage
 
 ### Create Tasks
@@ -860,6 +724,7 @@ agkan task tag delete "urgent"
 
 ## Task Statuses
 
+- **icebox**: Frozen tasks not actively being considered (white display)
 - **backlog**: Not yet started tasks (gray display)
 - **ready**: Tasks ready to be started (blue display)
 - **in_progress**: Tasks currently being worked on (yellow display)
@@ -867,6 +732,142 @@ agkan task tag delete "urgent"
 - **done**: Completed tasks (green display)
 - **closed**: Closed tasks (magenta display)
 
+## Configuration
+
+### Database Storage Location
+
+agkan allows customization of the database storage location via a configuration file.
+
+#### Configuration File: `.agkan.yml`
+
+Create a `.agkan.yml` file in your project root directory to specify the database storage location.
+
+**Configuration Example:**
+
+```yaml
+# Path to database file
+path: ./.agkan/data.db
+```
+
+#### Path Specification
+
+- **Relative Path**: Resolved relative to the current directory
+  ```yaml
+  path: ./data/kanban.db
+  path: ./.agkan/data.db
+  ```
+
+- **Absolute Path**: Used as-is
+  ```yaml
+  path: /home/user/.config/akan/data.db
+  ```
+
+#### Environment Variable Configuration
+
+agkan supports the `AGENT_KANBAN_DB_PATH` environment variable for specifying the database location. This is particularly useful in CI/CD environments and for managing multiple environments.
+
+**Setting the Environment Variable:**
+
+```bash
+# Use a custom database path
+export AGENT_KANBAN_DB_PATH=/path/to/your/database.db
+agkan task list
+
+# Use absolute path
+export AGENT_KANBAN_DB_PATH=/home/user/.config/akan/data.db
+
+# Use relative path
+export AGENT_KANBAN_DB_PATH=./custom/location/data.db
+```
+
+**Priority Order:**
+
+The database path is resolved in the following priority order:
+
+**Normal Mode (when `NODE_ENV` is not `test`):**
+1. **Environment Variable** (highest priority): `AGENT_KANBAN_DB_PATH`
+2. **Configuration File** (fallback): `path` field in `.agkan.yml`
+3. **Default Path** (lowest priority): `.agkan/data.db`
+
+**Test Mode (when `NODE_ENV=test`):**
+1. **Environment Variable** (highest priority): `AGENT_KANBAN_DB_PATH`
+2. **Configuration File** (fallback): `path` field in `.agkan-test.yml`
+3. **Default Path** (lowest priority): `.agkan-test/data.db`
+
+**Test Mode Explanation:**
+
+Test mode (`NODE_ENV=test`) automatically isolates test data from production data:
+
+- Uses separate configuration file: `.agkan-test.yml` instead of `.agkan.yml`
+- Uses separate default directory: `.agkan-test/` instead of `.agkan/`
+- Environment variable still takes highest priority in test mode
+- Prevents accidental mixing of test and production data
+
+**Use Cases:**
+
+1. **CI/CD Pipeline:**
+   ```bash
+   # Use temporary database for CI tests
+   export AGENT_KANBAN_DB_PATH=/tmp/ci-test-db.db
+   agkan task list
+   ```
+
+2. **Multiple Environments:**
+   ```bash
+   # Development environment
+   export AGENT_KANBAN_DB_PATH=./dev/data.db
+
+   # Staging environment
+   export AGENT_KANBAN_DB_PATH=./staging/data.db
+
+   # Production environment
+   export AGENT_KANBAN_DB_PATH=./prod/data.db
+   ```
+
+3. **Testing:**
+   ```bash
+   # Automated tests with isolated database
+   NODE_ENV=test npm 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
+   ```
+
+#### Default Behavior
+
+If no `.agkan.yml` file exists and no environment variable is set, the database is created in:
+
+```
+<current-directory>/.agkan/data.db
+```
+
+In test mode (`NODE_ENV=test`), the default location is:
+
+```
+<current-directory>/.agkan-test/data.db
+```
+
+#### Per-Project Management
+
+To manage separate tasks for different projects, place `.agkan.yml` in each project root:
+
+```bash
+# Project A
+cd /path/to/projectA
+cat > .agkan.yml << EOF
+path: ./.agkan/data.db
+EOF
+
+# Project B
+cd /path/to/projectB
+cat > .agkan.yml << EOF
+path: ./.agkan/data.db
+EOF
+```
+
+This enables independent task management for each project.
+
 ## Planned Features
 
 ### Task Attachments
@@ -964,7 +965,7 @@ agkan/
 | id | INTEGER | Primary key (auto-increment) |
 | title | TEXT | Task title (required) |
 | body | TEXT | Task body |
-| status | TEXT | Status (backlog, ready, in_progress, review, done, closed) |
+| 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) |

package/dist/cli/commands/agent-guide.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Agent guide command handler
+ */
+import { Command } from 'commander';
+export declare function setupAgentGuideCommand(program: Command): void;
+//# sourceMappingURL=agent-guide.d.ts.map

package/dist/cli/commands/agent-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent-guide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkTpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO7D"}