@geekbeer/minion 3.40.2 → 3.42.2

package/core/llm-plugins/claude/stream.js

@@ -36,6 +36,7 @@ function streamClaude(input, onEvent, ctx = {}) {
       cwd: config.HOME_DIR,
       stdio: ['pipe', 'pipe', 'pipe'],
       timeout: input.timeoutMs || 3600000, // 60 min default
+      shell: IS_WINDOWS, // Resolve .cmd shims (e.g. claude.cmd) on Windows
       env: {
         ...process.env,
         HOME: config.HOME_DIR,

package/core/llm-plugins/lib/spawn-helper.js

@@ -40,6 +40,7 @@ function spawnWithStdin({ binary, args, prompt, homeDir, env = {}, timeoutMs = 3
     const child = spawn(binary, args, {
       cwd: homeDir,
       stdio: ['pipe', 'pipe', 'pipe'],
+      shell: IS_WINDOWS, // Resolve .cmd shims (e.g. claude.cmd) on Windows
       env: {
         ...process.env,
         HOME: homeDir,

package/docs/api-reference.md

@@ -772,6 +772,125 @@ Response:
 
 プロジェクト変数はワークフロー実行時に `template_vars` としてミニオンに渡され、スキルの `{{VAR_NAME}}` テンプレートを展開する。
 
+### Project Tasks
+
+タスクは5段階Kanban (`backlog`/`todo`/`doing`/`review`/`done`)で管理される。親子関係は2階層まで(孫タスク禁止)。担当は **ミニオンか人間の二択**(両方は不可、後勝ち null)。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/projects/:projectId/tasks` | タスク一覧 |
+| POST | `/api/minion/projects/:projectId/tasks` | タスク作成 |
+| GET | `/api/minion/projects/:projectId/tasks/:taskId` | タスク詳細 |
+| PATCH | `/api/minion/projects/:projectId/tasks/:taskId` | タスク更新(部分更新) |
+| DELETE | `/api/minion/projects/:projectId/tasks/:taskId` | タスク削除(子タスクはCASCADE) |
+| POST | `/api/minion/projects/:projectId/tasks/reorder` | D&D 後の並び替え |
+
+GET クエリパラメータ:
+- `?milestone_id=<uuid>` または `?milestone_id=null` (マイルストーン未割当のみ)
+- `?status=backlog|todo|doing|review|done`
+- `?priority=high,urgent` (カンマ区切りで複数指定可。`low`/`normal`/`high`/`urgent`)
+- `?assignee_minion_id=<uuid>` / `?assignee_user_id=<uuid>`
+- `?parent_task_id=<uuid>` または `?parent_task_id=null` (親タスクのみ抽出可)
+- `?overdue=true` (`due_date < today AND status != 'done'`)
+- `?q=<keyword>` タイトル+説明の部分一致検索(pg_trgm + ILIKE。大小文字無視、日本語OK。ワイルドカード構文は使用不可 — リテラル部分文字列として扱われる)
+
+POST body:
+```json
+{
+  "title": "...",            // required, non-empty string
+  "description": null,
+  "status": "backlog",       // backlog|todo|doing|review|done (default: backlog)
+  "priority": "normal",      // low|normal|high|urgent (default: normal)
+  "milestone_id": null,
+  "parent_task_id": null,    // 指定時は子タスクとして作成。親が既に子の場合 400
+  "assignee_minion_id": null,
+  "assignee_user_id": null,  // assignee_minion_id と同時指定不可
+  "due_date": null           // YYYY-MM-DD
+}
+```
+
+ミニオン経由で作成したタスクには `created_by_minion_id` に自身のIDが自動設定される。
+
+PATCH body: 同じフィールドを任意で部分指定。**`status` を変更すると `status_changed_at` がサーバ側で自動更新される**(stalled 検出に使われる)。手動で `status_changed_at` を渡しても無視される。`assignee_minion_id` を set するともう一方の `assignee_user_id` は自動 null、その逆も同じ。
+
+reorder body:
+```json
+{
+  "task_id": "uuid",                // required
+  "status": "doing",                // 移動先カラム(省略時はそのまま)
+  "prev_task_id": null,             // 移動後の前隣タスク
+  "next_task_id": null              // 移動後の次隣タスク
+}
+```
+
+両 neighbor が null の場合は列の先頭/初期値で挿入される。
+
+### Project Milestones
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/projects/:projectId/milestones` | 一覧 |
+| POST | `/api/minion/projects/:projectId/milestones` | 作成 |
+| GET | `/api/minion/projects/:projectId/milestones/:milestoneId` | 詳細 |
+| PATCH | `/api/minion/projects/:projectId/milestones/:milestoneId` | 更新 |
+| DELETE | `/api/minion/projects/:projectId/milestones/:milestoneId` | 削除(タスクの `milestone_id` は SET NULL) |
+
+POST body:
+```json
+{
+  "title": "...",                    // required
+  "description": null,
+  "target_date": null,               // YYYY-MM-DD
+  "status": "planned"                // planned|in_progress|done|cancelled
+}
+```
+
+ミニオン作成時は `created_by_minion_id` が自動設定される。マイルストーンを削除しても紐づくタスクは残る(`milestone_id` だけ NULL になる)。
+
+### Project Health
+
+PMミニオンが朝のスタンドアップ等で叩く想定の集計エンドポイント。`tasks` と `milestones` を都度 fetch して集計するより、こちらの方がトークン効率が良い。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/projects/:projectId/health` | プロジェクト健康度サマリ |
+
+Response:
+```json
+{
+  "summary": {
+    "total_tasks": 42,
+    "by_status": {"backlog": 10, "todo": 8, "doing": 6, "review": 3, "done": 15},
+    "overdue": 4,
+    "stalled": 2
+  },
+  "milestones": [
+    {
+      "id": "...",
+      "title": "MVP リリース",
+      "target_date": "2026-05-31",
+      "status": "in_progress",
+      "total": 12,
+      "done": 5,
+      "progress_pct": 41.7,
+      "overdue_count": 1,
+      "days_remaining": 39
+    }
+  ]
+}
+```
+
+定義:
+- `overdue`: `due_date < today AND status != 'done'`
+- `stalled`: `status = 'doing' AND status_changed_at < now() - 5 days`
+- `progress_pct`: マイルストーン内 **leafタスク** の `done / total` × 100 (小数1桁)
+- `days_remaining`: `target_date - today` の日数(target_date が null なら null)
+
+**マイルストーン集計の考え方**:
+- `total` / `done` / `overdue_count` は **leaf タスクのみ** を対象にする(子を持つ親 EPIC は集計から除外、コンテナとみなす)。
+- 子タスクが `milestone_id=null` でも、親 EPIC の `milestone_id` を継承して集計される(effective milestone)。つまり「親に MVP を付ければ配下の子タスクも MVP 進捗に含まれる」。
+- `summary.by_status` は従来どおり全タスク(親含む)で計上する。
+
 ### Workflow Variables (PM only)
 
 | Method | Endpoint | Description |

package/docs/task-guides.md

@@ -562,6 +562,119 @@ curl -s -X PUT "$HQ_URL/api/minion/me/project/<project-id>/context" \
 
 ---
 
+## プロジェクトタスク管理
+
+タスクは5段階Kanban (`backlog`/`todo`/`doing`/`review`/`done`)で管理する。詳細なAPI仕様は `~/.minion/docs/api-reference.md` の「Project Tasks」「Project Milestones」「Project Health」を参照。
+
+### PM ロールの典型操作
+
+#### 1. 朝の健康度チェック
+
+```bash
+curl -s "$HQ_URL/api/minion/projects/<project-id>/health" \
+  -H "Authorization: Bearer $API_TOKEN"
+```
+
+`overdue > 0` または `stalled > 0` のタスクを抽出してフォローアップ:
+
+```bash
+# 過遅れタスク一覧
+curl -s "$HQ_URL/api/minion/projects/<project-id>/tasks?overdue=true" \
+  -H "Authorization: Bearer $API_TOKEN"
+
+# 5日以上 doing のまま停滞しているタスク
+curl -s "$HQ_URL/api/minion/projects/<project-id>/tasks?status=doing" \
+  -H "Authorization: Bearer $API_TOKEN" | \
+  jq '[.[] | select(.status_changed_at < (now - 5*86400 | todate))]'
+```
+
+#### 2. ユーザー要望をエピック+タスクに分解
+
+```bash
+# 1. エピック(親タスク)を作成。マイルストーンは親にだけ付ければ OK(子は継承して集計される)
+curl -X POST "$HQ_URL/api/minion/projects/<project-id>/tasks" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"title":"認証フロー実装","status":"todo","priority":"high","milestone_id":"<m-uuid>"}'
+# レスポンスの id を <epic-id> として控える
+
+# 2. 子タスクを複数作成して engineer ミニオンに割り当て
+curl -X POST "$HQ_URL/api/minion/projects/<project-id>/tasks" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"title":"DBスキーマ設計","parent_task_id":"<epic-id>","priority":"normal","assignee_minion_id":"<eng-id>"}'
+```
+
+注意: 親タスクが既に子タスク(=2階層目)の場合、子を作ろうとすると 400 が返る。**孫タスクは作れない**。
+
+**priority ガイド**:
+- `urgent`: 今日中に着手が必要。インシデント対応や本番影響あり
+- `high`: 今週中に終わらせたい。マイルストーンのクリティカルパス
+- `normal`: 通常(default)
+- `low`: 余裕があればやる改善/nice-to-have
+
+**タスクの検索**(キーワードで絞り込み):
+
+```bash
+# タイトル + 説明文を部分一致検索(日本語OK、大小文字無視)
+curl -s "$HQ_URL/api/minion/projects/<project-id>/tasks?q=認証" \
+  -H "Authorization: Bearer $API_TOKEN"
+
+# priority で絞り込み(カンマ区切り複数可)
+curl -s "$HQ_URL/api/minion/projects/<project-id>/tasks?priority=high,urgent" \
+  -H "Authorization: Bearer $API_TOKEN"
+```
+
+#### 3. マイルストーン管理
+
+```bash
+# 作成
+curl -X POST "$HQ_URL/api/minion/projects/<project-id>/milestones" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"title":"MVP リリース","target_date":"2026-05-31","status":"planned"}'
+
+# ステータス更新
+curl -X PATCH "$HQ_URL/api/minion/projects/<project-id>/milestones/<m-id>" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"status":"in_progress"}'
+```
+
+### Engineer ロールの典型操作
+
+#### 1. 自分にアサインされたタスクを取得
+
+```bash
+curl -s "$HQ_URL/api/minion/projects/<project-id>/tasks?assignee_minion_id=$MINION_ID&status=todo" \
+  -H "Authorization: Bearer $API_TOKEN"
+```
+
+#### 2. 進捗マーク
+
+```bash
+# 着手 (status_changed_at がサーバ側で自動更新されるので、stalled 検出が正しく動く)
+curl -X PATCH "$HQ_URL/api/minion/projects/<project-id>/tasks/<task-id>" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"status":"doing"}'
+
+# レビュー依頼
+curl -X PATCH "$HQ_URL/api/minion/projects/<project-id>/tasks/<task-id>" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"status":"review"}'
+
+# 完了
+curl -X PATCH "$HQ_URL/api/minion/projects/<project-id>/tasks/<task-id>" \
+  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"status":"done"}'
+```
+
+### 共通の注意
+
+- **`status_changed_at` を手動で渡してはならない**。サーバ側で自動更新される(stalled 検出に使われる)。
+- **`assignee_minion_id` と `assignee_user_id` は二者択一**。どちらかを set すると、もう一方は自動で null になる。
+- **タスク削除はCASCADE**。エピックを消すと子タスクも全て消えるので注意。
+- **マイルストーン削除時、紐づくタスクの `milestone_id` は SET NULL**(タスク自体は残る)。
+- **作成・編集したタスク/マイルストーンには `created_by_minion_id` が自動記録される**ので、誰が起票したかを後追いできる。
+
+---
+
 ## 実行結果の確認
 
 ### ローカル実行履歴

package/linux/routes/chat.js

@@ -410,6 +410,13 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
             `プロジェクト情報を取得するには以下を実行してください:`,
             `  hq fetch project ${context.projectId}`,
             `  hq fetch project-context ${context.projectId}`,
+            `タスク・マイルストーン・健康度を扱う場合は以下のAPIを使えます (Bearer 認証必須):`,
+            `  GET    \$HQ_URL/api/minion/projects/${context.projectId}/tasks       # 一覧 (?milestone_id= ?status= ?priority=high,urgent ?assignee_minion_id= ?overdue=true ?q=<substring> 等で絞り込み可。q は日本語OKの部分一致)`,
+            `  POST   \$HQ_URL/api/minion/projects/${context.projectId}/tasks       # 作成 (body: title, description?, status?, priority?, milestone_id?, parent_task_id?, assignee_minion_id?, due_date?)`,
+            `  PATCH  \$HQ_URL/api/minion/projects/${context.projectId}/tasks/<id>  # 更新 (status変更で status_changed_at がサーバ自動更新、priority 変更も可)`,
+            `  GET    \$HQ_URL/api/minion/projects/${context.projectId}/milestones  # マイルストーン一覧`,
+            `  GET    \$HQ_URL/api/minion/projects/${context.projectId}/health      # 健康度サマリ (overdue/stalled/マイルストーン進捗。progress_pct は leaf タスク基準)`,
+            `タスクは5段階Kanban (backlog→todo→doing→review→done)、親子は2階層まで(孫不可)。priority は low|normal|high|urgent (可視化+フィルタ用)。親EPICに milestone_id を付ければ子タスクも進捗に自動反映される。詳細は ~/.minion/docs/api-reference.md の「Project Tasks」「Project Milestones」「Project Health」を参照。`,
             `取得した内容をもとに回答してください。`
           )
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "3.40.2",
+  "version": "3.42.2",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/rules/core.md

@@ -36,6 +36,14 @@ Minion
     - **transform ノードの I/O 型は edge の contract から自動導出**。incoming edge と outgoing edge にそれぞれ contract を必ず貼ること。`transform_instruction` は contract だけで意図が伝わらない場合の補足ヒント（任意）
     - **fan_out の incoming edge に contract を貼る場合**、`fan_out_source` が指すフィールドが contract 内に `type='array'` として宣言されている必要がある（静的検証で弾かれる）
 - **Routine**: ミニオンスコープ。ミニオンローカルの定期タスク。
+- **Project Tasks / Milestones**: プロジェクトスコープ。**人間+ミニオンが共有するタスクボード**(5段階Kanban: `backlog`→`todo`→`doing`→`review`→`done`)とロードマップ(マイルストーン)。ミニオンは `/api/minion/projects/:projectId/{tasks,milestones,health}` で操作可能。
+  - PMロールは朝のチェックで `/health` を叩いて遅延・停滞タスクを把握、ユーザー要望をエピック+子タスクに分解
+  - Engineerロールは `?assignee_minion_id=$MINION_ID` で自分のタスクを取得し、着手時に `status: doing` へ更新(以降 `status_changed_at` がサーバ側で自動更新され、停滞検出に使われる)
+  - 親子は2階層のみ(孫タスク禁止)、担当は **ミニオン or 人間** の二択
+  - **priority**: `low` / `normal` / `high` / `urgent` (default `normal`)。可視化とフィルタ用途(並び順は `sort_order` が優先)
+  - **`milestone_id` は親 EPIC に付ければ配下の子タスクも自動的にその進捗に含まれる**(effective milestone)。子を個別にひもづけ直す必要はない。`/health` は leaf タスク基準で `progress_pct` を算出する
+  - **タスク検索**: `?q=<keyword>` でタイトル+説明の部分一致検索(pg_trgm、日本語OK)、`?priority=high,urgent` でカンマ区切り複数指定
+  - 詳細は `~/.minion/docs/api-reference.md` の「Project Tasks」「Project Milestones」「Project Health」と `~/.minion/docs/task-guides.md` の「プロジェクトタスク管理」を参照
 - **Workspace**: ミニオンは複数のワークスペースに所属でき、スキルやプロジェクトはワークスペース単位でスコープされる。チャットセッションもワークスペース別に分離される。所属ワークスペースはハートビートで自動同期され、`hq list workspaces` で確認できる。
 - ミニオンは複数プロジェクトに `pm`、`engineer`、`accountant` として参加できる。
 

package/win/routes/chat.js

@@ -473,6 +473,13 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
             `プロジェクト情報を取得するには以下を実行してください:`,
             `  hq fetch project ${context.projectId}`,
             `  hq fetch project-context ${context.projectId}`,
+            `タスク・マイルストーン・健康度を扱う場合は以下のAPIを使えます (Bearer 認証必須):`,
+            `  GET    \$HQ_URL/api/minion/projects/${context.projectId}/tasks       # 一覧 (?milestone_id= ?status= ?priority=high,urgent ?assignee_minion_id= ?overdue=true ?q=<substring> 等で絞り込み可。q は日本語OKの部分一致)`,
+            `  POST   \$HQ_URL/api/minion/projects/${context.projectId}/tasks       # 作成 (body: title, description?, status?, priority?, milestone_id?, parent_task_id?, assignee_minion_id?, due_date?)`,
+            `  PATCH  \$HQ_URL/api/minion/projects/${context.projectId}/tasks/<id>  # 更新 (status変更で status_changed_at がサーバ自動更新、priority 変更も可)`,
+            `  GET    \$HQ_URL/api/minion/projects/${context.projectId}/milestones  # マイルストーン一覧`,
+            `  GET    \$HQ_URL/api/minion/projects/${context.projectId}/health      # 健康度サマリ (overdue/stalled/マイルストーン進捗。progress_pct は leaf タスク基準)`,
+            `タスクは5段階Kanban (backlog→todo→doing→review→done)、親子は2階層まで(孫不可)。priority は low|normal|high|urgent (可視化+フィルタ用)。親EPICに milestone_id を付ければ子タスクも進捗に自動反映される。詳細は ~/.minion/docs/api-reference.md の「Project Tasks」「Project Milestones」「Project Health」を参照。`,
             `取得した内容をもとに回答してください。`
           )
         }