@geekbeer/minion 3.59.3 → 3.59.8

package/core/meetings/meeting-mcp-server.js

@@ -17,7 +17,15 @@
  *
  *   meeting_leave()
  *     Records left_at for this minion. Returns { ok: true }; claude should
- *     exit its participation loop after this call.
+ *     exit its participation loop after this call. **Does NOT delete the
+ *     meeting room** — only this minion's own departure is recorded.
+ *
+ *   meeting_end()
+ *     End and delete the meeting room (host minion only). Cascades to
+ *     participants/messages and pushes end-notices to all other minions
+ *     so their tmux sessions terminate. Returns { ok: true } or 403 if
+ *     the calling minion is not the host. Use this when YOU created the
+ *     meeting (via POST /api/minion/meetings) and the discussion is over.
  *
  * Environment (passed by meeting-runner):
  *   MINION_MEETING_ID   - meeting UUID
@@ -105,6 +113,22 @@ async function leave() {
   return { ok: true }
 }
 
+async function endMeeting() {
+  const { resp, data } = await hqFetch(`/api/minion/meetings/${MEETING_ID}`, {
+    method: 'DELETE',
+  })
+  if (resp.status === 404 || data.meeting_ended) {
+    return { ok: true, meeting_ended: true }
+  }
+  if (resp.status === 403) {
+    throw new Error(data.error || 'Only the host minion can end this meeting')
+  }
+  if (!resp.ok) {
+    throw new Error(data.error || `end failed: ${resp.status}`)
+  }
+  return { ok: true }
+}
+
 // --- Tool definitions --------------------------------------------------------
 
 function toolsList() {
@@ -143,8 +167,19 @@ function toolsList() {
     {
       name: 'meeting_leave',
       description:
-        'Leave the meeting. Call this when the meeting is over or you have been ' +
-        'explicitly excused. After calling this, exit your participation loop.',
+        'Leave the meeting (depart, do NOT delete the room). Records your left_at. ' +
+        'Use this when you have been excused but the meeting continues without you. ' +
+        'If you are the host and the discussion is over, call meeting_end instead.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'meeting_end',
+      description:
+        'End and delete the meeting room (host minion only). Cascades to participants ' +
+        'and messages and shuts down every other minion in the room. Call this when ' +
+        'YOU created the meeting and the discussion is concluded — meeting_leave only ' +
+        'records your own departure and leaves the room hanging. Fails with 403 if you ' +
+        'are not the host.',
       inputSchema: { type: 'object', properties: {} },
     },
   ]
@@ -160,6 +195,8 @@ async function handleToolCall(name, args) {
       return getState()
     case 'meeting_leave':
       return leave()
+    case 'meeting_end':
+      return endMeeting()
     default:
       throw new Error(`Unknown tool: ${name}`)
   }

package/core/meetings/meeting-prompt.js

@@ -34,6 +34,14 @@ function buildMeetingKickoffPrompt({ meetingId, title, purpose, host, selfName,
     '5. `meeting_wait_for_next_message` の戻り値が `{ meeting_ended: true }` になったら',
     '   `meeting_leave` を呼んでループを終了する',
     '',
+    '## ミーティングの終了 (leave と end の使い分け)',
+    '',
+    '- **`meeting_leave`**: 自分だけ退席する。ルームは残り、他参加者は続行可能。',
+    '  「あなただけ退席してOK」と明示された時のみ使う。',
+    '- **`meeting_end`**: ルームを削除して全員を解散する。**ホストのみ呼び出せる** (403になる)。',
+    '  あなたが招集したミーティングで議論が終わったら `meeting_end` を呼ぶこと。',
+    '  `meeting_leave` だけだとルームが孤児として残り続けるので注意。',
+    '',
     '## 発言ガイドライン',
     '- 1回の発言は **2-3 文以内** を基本とする (会議でだらだら話さない)',
     '- 議論を前進させる発言を優先する (賛否・確認・代替案・質問)',

package/docs/api-reference.md

@@ -1989,13 +1989,17 @@ hq note search <project_id> "キーワード"
 
 ### Meeting Rooms 🧪 (HQ, experimental, v3.59.0〜)
 
-ミーティング機能はミニオン上の `meeting` MCP サーバーが叩く HQ エンドポイント。通常 AI 側から直接コールすることはなく、招待 (`POST /api/meetings/invitations` をミニオンが受信) で起動された claude セッションが MCP ツール経由で利用する。
+ミーティング機能はミニオン上の `meeting` MCP サーバーが叩く HQ エンドポイント。**参加中**の操作は MCP ツール経由で自動的に叩かれるが、**自分で会議を招集する**場合 (例: PMミニオンが朝会を主催) は `POST /api/minion/meetings` をルーティン/スキルから直接叩く。
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
+| POST | `/api/minion/meetings` | **会議室を作成して参加者を招待する。** Body: `{project_id, title, purpose?, invitees?: [{type: 'user'\|'minion', id}]}`。呼び出し元ミニオンは自動でホスト+参加者になる。プロジェクトメンバーかつ `experimental_meetings` 有効ワークスペースで動作 |
 | GET | `/api/minion/meetings/:id` | ミーティングのメタデータ + 参加者一覧。`meeting_get_state` ツールから呼ばれる |
 | GET | `/api/minion/meetings/:id/messages?after=<iso>&wait=true` | long-poll で次の発言を待機 (最大 ~25秒)。404 = 会議終了 |
 | POST | `/api/minion/meetings/:id/messages` | 発言。Body: `{text}` |
-| POST | `/api/minion/meetings/:id` | アクション。Body: `{action: 'leave' \| 'heartbeat'}` |
+| POST | `/api/minion/meetings/:id` | アクション。Body: `{action: 'leave' \| 'heartbeat'}`。`leave` は自分の `left_at` を記録するだけでルームは残る |
+| DELETE | `/api/minion/meetings/:id` | **ルームを削除して会議を終了する** (ホストミニオン限定、403 if not host)。CASCADE で participants/messages 削除 + 他参加ミニオンに終了通知 push |
 
-これらは MCP ツール (`meeting_wait_for_next_message`, `meeting_speak`, `meeting_leave`) として claude に公開される。直接叩く必要はない。
+参加中の操作 (GET state / long-poll messages / speak / leave / end / heartbeat) は MCP ツール (`meeting_get_state`, `meeting_wait_for_next_message`, `meeting_speak`, `meeting_leave`, `meeting_end`) として claude に公開されるため、直接叩く必要はない。会議の**作成**だけはルーティン/スキルから明示的に叩く必要がある (作成後は HQ がプッシュした招待で各ミニオンに mt-* tmux セッションが立ち上がる)。
+
+**leave と end の違い**: `meeting_leave` は自分だけ退席するアクション (ルームは残る)、`meeting_end` (DELETE) はルームごと削除して全員解散させるアクション (ホストミニオン限定)。自分が招集した会議が終わったら必ず `meeting_end` を呼ばないとルームが孤児として残る。

package/docs/task-guides.md

@@ -821,6 +821,38 @@ curl -H "Authorization: Bearer $API_TOKEN" http://localhost:8080/api/meetings/ac
 
 セッション復帰機構は未実装。tmux/claude が落ちた場合は再起動されず、新しい招待を待つ。
 
+### ミーティングを自分で招集する (v3.59.6〜)
+
+PMロール等で「自分が会議を主催したい」場合は HQ の `POST /api/minion/meetings` を直接叩く。呼び出し元ミニオンは自動でホスト + 参加者になり、`invitees` で指定した他ミニオン・人間が `meeting_participants` に挿入される。他ミニオンへの招待は HQ がプッシュするので、こちら側で追加処理は不要。
+
+```bash
+curl -X POST "$HQ_URL/api/minion/meetings" \
+  -H "Authorization: Bearer $API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "project_id": "<project-uuid>",
+    "title": "朝会 2026-05-15",
+    "purpose": "前日進捗の共有とブロッカーの洗い出し",
+    "invitees": [
+      {"type": "minion", "id": "<other-minion-uuid>"},
+      {"type": "user", "id": "<user-uuid>"}
+    ]
+  }'
+```
+
+**前提条件:**
+- 自分がそのプロジェクトの `project_members` に登録されていること (403 が返るならPMに依頼)
+- プロジェクトが所属する workspace の `feature_flags.experimental_meetings = true` (人間管理者しか有効化できない)
+- 作成成功後、自分自身のミニオンにも招待が届き `mt-{id8}` tmux セッションが起動する
+
+**会議の終了 (ホストの責務):**
+自分が招集した会議で議論が終わったら、MCP ツール `meeting_end` を呼んでルームを削除する。`meeting_leave` は自分が退席するだけでルームは残るため、ホストが leave で抜けるとルームが孤児になり HQ ダッシュボードのアクティブ会議室一覧に居座り続ける。`meeting_end` は ホストミニオン限定 (それ以外は 403)。
+
+```
+meeting_end()  # DELETE /api/minion/meetings/:id を裏で叩く
+# → 全参加ミニオンに終了通知が push され、各 mt-* tmux が終了する
+```
+
 ## ツール・MCPサーバーのインストール
 
 スキルが `requires` で宣言している MCP サーバーや CLI ツールが不足している場合は、`~/.minion/docs/environment-setup.md` の手順に従ってインストールする。

package/linux/meeting-runner.js

@@ -165,6 +165,7 @@ async function runMeeting({ meetingId, title, purpose, host, hqUrl, selfName, ro
       'mcp__meeting__meeting_speak',
       'mcp__meeting__meeting_get_state',
       'mcp__meeting__meeting_leave',
+      'mcp__meeting__meeting_end',
     ].join(',')
     const llmCommand = `${claudeBin} -p --mcp-config "${mcpConfigFile}" --allowedTools "${allowedTools}" < "${promptFile}"`
 

package/package.json

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

package/rules/core.md

@@ -279,7 +279,7 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 
 ## Meeting Participation (ミーティング参加, experimental, v3.59.0〜)
 
-HQ からミーティング招待 (`POST /api/meetings/invitations`) を受け取ると、専用 tmux セッション `mt-{meetingId8}` で claude が起動し、`meeting` MCP サーバー経由で会議に参加する。
+HQ からミーティング招待 (`POST /api/meetings/invitations`) を受け取ると、専用 tmux セッション `mt-{meetingId8}` で claude が起動し、`meeting` MCP サーバー経由で会議に参加する。**自分から会議を招集する** (`POST $HQ_URL/api/minion/meetings`) ことも可能 (v3.59.6〜、PMロール推奨)。詳細は `~/.minion/docs/task-guides.md` の「ミーティングを自分で招集する」を参照。
 
 **基本ループ:**
 1. `meeting_get_state` で参加者・目的・タイトルを把握
@@ -291,6 +291,11 @@ HQ からミーティング招待 (`POST /api/meetings/invitations`) を受け
 4. 応答すべきなら `meeting_speak` で **1-3 文程度** の発言を送信
 5. 戻り値が `{ meeting_ended: true }` になったら `meeting_leave` を呼んで終了
 
+**`meeting_leave` と `meeting_end` の使い分け** (v3.59.7〜):
+- `meeting_leave` = 自分だけ退席。ルームは残り議論は続行
+- `meeting_end` = ルームごと削除して全員解散 (**ホストミニオンのみ**、403になる)
+- 自分が招集した会議で議論が終わったら **必ず `meeting_end`** を呼ぶこと。`meeting_leave` だけだとルームが孤児として残る
+
 **振る舞いのルール:**
 - 発言は短く保つ (会議でだらだら話さない)
 - 他のミニオンの発言と重複しない (既に同じ趣旨を誰かが言っていたら追従しない)

package/win/meeting-runner.js

@@ -130,6 +130,7 @@ async function runMeeting({ meetingId, title, purpose, host, hqUrl, selfName, ro
       'mcp__meeting__meeting_speak',
       'mcp__meeting__meeting_get_state',
       'mcp__meeting__meeting_leave',
+      'mcp__meeting__meeting_end',
     ].join(',')
 
     await fs.writeFile(

package/win/minion-cli.ps1

@@ -48,10 +48,15 @@ $needsAdmin = $Command -in $adminRequired
 # `stop --force` rewrites NSSM AppExit config and may need to kill processes
 # owned by the service account → requires Administrator.
 if ($Command -eq 'stop' -and $Force) { $needsAdmin = $true }
+# `restart --all` triggers the MinionVNC schtask which is registered with
+# /RL HIGHEST, so schtasks /Run requires Administrator.
+if ($Command -eq 'restart' -and $All) { $needsAdmin = $true }
 if ($needsAdmin) {
     $currentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
     if (-not $currentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
-        $label = if ($Command -eq 'stop' -and $Force) { 'stop --force' } else { $Command }
+        $label = if ($Command -eq 'stop' -and $Force) { 'stop --force' }
+                 elseif ($Command -eq 'restart' -and $All) { 'restart --all' }
+                 else { $Command }
         Write-Host "ERROR: '$label' requires Administrator privileges." -ForegroundColor Red
         Write-Host "  Right-click PowerShell and select 'Run as administrator'." -ForegroundColor Yellow
         exit 1
@@ -585,7 +590,7 @@ function Restart-AllMinionServices {
     foreach ($svc in $services) {
         $state = Get-ServiceState $svc
         if (-not $state) {
-            Write-Warn "$svc: not installed, skipping"
+            Write-Warn "${svc}: not installed, skipping"
             continue
         }
         if ($state -ne 'STOPPED') {
@@ -614,9 +619,17 @@ function Restart-AllMinionServices {
     }
 
     # Step 5: Re-trigger user-session logon tasks. schtasks /Run is a no-op if
-    # the task is already running, so this is safe regardless of current state.
-    schtasks /Run /TN MinionVNC 2>$null | Out-Null
-    schtasks /Run /TN MinionWSL 2>$null | Out-Null
+    # the task is already running. MinionVNC is /RL HIGHEST so we require
+    # Administrator at the entry point (see needsAdmin check above), which
+    # is what allows this /Run to succeed.
+    foreach ($task in @('MinionVNC', 'MinionWSL')) {
+        $output = & schtasks /Run /TN $task 2>&1
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "Triggered logon task: $task"
+        } else {
+            Write-Warn "Logon task '$task' could not be triggered: $output"
+        }
+    }
 
     Write-Host "All minion services restarted"
 }
@@ -1874,7 +1887,7 @@ switch ($Command) {
         Write-Host "  stop          Stop the minion-agent service (graceful)"
         Write-Host "  stop --force  Force-stop all minion services & processes (admin required)"
         Write-Host "  restart       Restart the minion-agent service"
-        Write-Host "  restart --all Restart all minion services (agent + websockify + cloudflared)"
+        Write-Host "  restart --all Restart all minion services + logon tasks (admin required)"
         Write-Host "  status        Show agent service status"
         Write-Host "  health        Check agent health endpoint"
         Write-Host "  daemons       Show all daemon service status"
@@ -1902,5 +1915,6 @@ switch ($Command) {
         Write-Host "                       minion-cloudflared, then re-trigger MinionVNC/MinionWSL"
         Write-Host "                       logon tasks. Use after Windows Update or when only"
         Write-Host "                       some services came back online."
+        Write-Host "                       Requires Administrator (MinionVNC schtask is /RL HIGHEST)."
     }
 }