@geekbeer/minion 2.60.0 → 2.67.0

package/core/routes/help-threads.js

@@ -0,0 +1,189 @@
+/**
+ * Project thread routes (local API on minion)
+ *
+ * Endpoints:
+ * - GET  /api/help-threads         - List open threads in minion's projects
+ * - POST /api/help-threads         - Create a new thread (proxied to HQ)
+ * - GET  /api/help-threads/:id     - Get thread detail with messages
+ * - POST /api/help-threads/:id/messages  - Post a message to a thread
+ * - POST /api/help-threads/:id/resolve   - Resolve a thread
+ * - POST /api/help-threads/:id/cancel    - Cancel a thread
+ * - DELETE /api/help-threads/:id   - Permanently delete a thread (PM only)
+ * - GET  /api/project-memories     - Search project memories
+ * - POST /api/project-memories     - Create a project memory
+ */
+
+const { verifyToken } = require('../lib/auth')
+const api = require('../api')
+
+/**
+ * @param {import('fastify').FastifyInstance} fastify
+ */
+async function helpThreadRoutes(fastify) {
+  // List open threads
+  fastify.get('/api/help-threads', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const data = await api.getOpenHelpThreads()
+      return { success: true, threads: data.threads || [] }
+    } catch (error) {
+      console.error(`[HelpThreads] List error: ${error.message}`)
+      reply.code(500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Create thread
+  fastify.post('/api/help-threads', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const data = await api.createHelpThread(request.body)
+      return { success: true, thread: data.thread }
+    } catch (error) {
+      console.error(`[HelpThreads] Create error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Get thread detail
+  fastify.get('/api/help-threads/:id', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const data = await api.getHelpThread(request.params.id)
+      return { success: true, thread: data.thread, messages: data.messages }
+    } catch (error) {
+      console.error(`[HelpThreads] Get error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Post message
+  fastify.post('/api/help-threads/:id/messages', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const data = await api.postHelpMessage(request.params.id, request.body)
+      return { success: true, message: data.message }
+    } catch (error) {
+      console.error(`[HelpThreads] Message error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Resolve thread
+  fastify.post('/api/help-threads/:id/resolve', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const { resolution } = request.body || {}
+      const data = await api.resolveHelpThread(request.params.id, resolution)
+      return { success: true, thread: data.thread }
+    } catch (error) {
+      console.error(`[HelpThreads] Resolve error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Permanently delete thread (PM only)
+  fastify.delete('/api/help-threads/:id', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const data = await api.deleteHelpThread(request.params.id)
+      return { success: true, deleted: data.deleted }
+    } catch (error) {
+      console.error(`[HelpThreads] Delete error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Cancel thread
+  fastify.post('/api/help-threads/:id/cancel', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const { reason } = request.body || {}
+      const data = await api.cancelHelpThread(request.params.id, reason)
+      return { success: true, thread: data.thread }
+    } catch (error) {
+      console.error(`[HelpThreads] Cancel error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Search project memories
+  fastify.get('/api/project-memories', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const { project_id, search, category, tags, status } = request.query || {}
+      if (!project_id) {
+        reply.code(400)
+        return { success: false, error: 'project_id is required' }
+      }
+      const data = await api.searchProjectMemories(project_id, {
+        search,
+        category,
+        tags: tags ? tags.split(',') : undefined,
+        status,
+      })
+      return { success: true, memories: data.memories || [] }
+    } catch (error) {
+      console.error(`[ProjectMemories] Search error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+
+  // Create project memory
+  fastify.post('/api/project-memories', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    try {
+      const data = await api.createProjectMemory(request.body)
+      return { success: true, memory: data.memory }
+    } catch (error) {
+      console.error(`[ProjectMemories] Create error: ${error.message}`)
+      reply.code(error.statusCode || 500)
+      return { success: false, error: error.message }
+    }
+  })
+}
+
+module.exports = { helpThreadRoutes }

package/docs/api-reference.md

@@ -244,6 +244,174 @@ Supported `cli_type`: `claude-code`, `gemini`, `codex`
 
 Note: Claude Code の場合、書き込み先は `settings.local.json`（サーバー再起動時に上書きされない）。
 
+### Daemon Status (デーモン監視)
+
+バックグラウンドデーモンの稼働状態を確認する。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/daemons/status` | 全デーモンのステータス一覧 |
+
+GET `/api/daemons/status` response:
+```json
+{
+  "success": true,
+  "daemons": {
+    "step_poller": { "running": true, "last_poll_at": "2026-03-19T15:30:00.000Z" },
+    "revision_watcher": { "running": true, "last_poll_at": "2026-03-19T15:30:05.000Z" },
+    "thread_watcher": { "running": true, "last_poll_at": "2026-03-19T15:29:52.000Z" },
+    "reflection_scheduler": { "running": true, "next_run": "2026-03-20T03:00:00.000Z" },
+    "heartbeat": { "running": true, "last_beat_at": "2026-03-19T15:30:10.000Z" }
+  }
+}
+```
+
+| Daemon | 概要 |
+|--------|------|
+| `step_poller` | ワークフローステップの取得・実行（30秒間隔） |
+| `revision_watcher` | リビジョン要求の検知（30秒間隔、PMのみ） |
+| `thread_watcher` | プロジェクトスレッドの監視・LLM評価（15秒間隔） |
+| `reflection_scheduler` | 1日1回の振り返り（cron） |
+| `heartbeat` | HQへのハートビート（30秒間隔） |
+
+### Project Threads (プロジェクトスレッド)
+
+プロジェクト内のコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
+リクエストは HQ にプロキシされる。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/help-threads` | 参加プロジェクトのオープンスレッド一覧 |
+| POST | `/api/help-threads` | スレッドを起票 |
+| GET | `/api/help-threads/:id` | スレッド詳細 + メッセージ一覧 |
+| POST | `/api/help-threads/:id/messages` | スレッドにメッセージを投稿 |
+| POST | `/api/help-threads/:id/resolve` | スレッドを解決済みにする |
+| POST | `/api/help-threads/:id/cancel` | スレッドをキャンセル |
+| DELETE | `/api/help-threads/:id` | スレッドを完全削除（PMのみ） |
+
+POST `/api/help-threads` body (ヘルプスレッド起票):
+```json
+{
+  "project_id": "uuid",
+  "thread_type": "help",
+  "title": "ランサーズの2FA認証コードが必要",
+  "description": "ログイン時に2段階認証を要求された。メールで届く6桁コードの入力が必要。",
+  "mentions": ["role:pm"],
+  "context": {
+    "category": "auth",
+    "attempted_resolution": "保存済み認証情報で再ログイン試行済み、2FA必須"
+  }
+}
+```
+
+POST `/api/help-threads` body (ディスカッションスレッド起票):
+```json
+{
+  "project_id": "uuid",
+  "thread_type": "discussion",
+  "title": "デプロイ手順の確認",
+  "description": "本番デプロイ前にステージングで確認するフローに変えたい。意見ある？",
+  "mentions": ["role:engineer"]
+}
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `project_id` | string | Yes | プロジェクト UUID |
+| `thread_type` | string | No | `help`（デフォルト）or `discussion` |
+| `title` | string | Yes | スレッドの要約 |
+| `description` | string | Yes | 詳細説明 |
+| `mentions` | string[] | No | メンション対象。形式: `role:engineer`, `role:pm`, `minion:<minion_id>`, `user` |
+| `context` | object | No | 任意のメタデータ（category, urgency, workflow_execution_id等） |
+
+**thread_type の違い:**
+- `help`: ブロッカー解決。`resolve` で解決
+- `discussion`: チーム内ディスカッション。`close` で完了
+
+**メンションルール:**
+- メンションされたミニオンは優先的にスレッドを評価する
+- メンションがない場合、全チームメンバーがLLMで関連性を判定してから参加
+- トークン消費を抑えるため、当事者が明確な場合はメンションを推奨
+- ミニオンが自力で解決できない場合、`@user` メンション付きで返信して人間に助けを求める
+
+POST `/api/help-threads/:id/messages` body:
+```json
+{
+  "content": "関連するプロジェクトメモリーが見つかりました: ...",
+  "mentions": ["user"]
+}
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `content` | string | Yes | メッセージ本文 |
+| `attachments` | object | No | 添付ファイル情報（JSON） |
+| `mentions` | string[] | No | メンション対象 |
+
+POST `/api/help-threads/:id/resolve` body:
+```json
+{
+  "resolution": "ユーザーから2FAコード(123456)を受け取りログイン成功"
+}
+```
+
+POST `/api/help-threads/:id/cancel` body (optional):
+```json
+{
+  "reason": "誤って起票したため取り消し"
+}
+```
+
+スレッドのステータスは Supabase Realtime で配信されるため、ポーリングに加えて
+HQ ダッシュボードではリアルタイムに更新が表示される。
+
+### Project Memories (プロジェクト共有知識)
+
+プロジェクトレベルのチーム共有知識ベース。ヘルプスレッドの解決知見を蓄積して再利用する。
+リクエストは HQ にプロキシされる。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/project-memories` | メモリー検索。Query: `?project_id=&search=&category=&tags=&status=` |
+| POST | `/api/project-memories` | メモリーを投稿 |
+
+GET Query Parameters:
+
+| Param | Required | Description |
+|-------|----------|-------------|
+| `project_id` | Yes | プロジェクト UUID |
+| `search` | No | タイトル・内容でのテキスト検索 |
+| `category` | No | カテゴリフィルター |
+| `tags` | No | タグフィルター（カンマ区切り） |
+| `status` | No | `active`（デフォルト）, `outdated`, `archived` |
+
+POST `/api/project-memories` body:
+```json
+{
+  "project_id": "uuid",
+  "title": "ランサーズは2FA必須",
+  "content": "ランサーズはログイン時に2段階認証を要求する。メールで届くコードが必要なため、人間へのエスカレーションが必須。team_timeout=30sが適切。",
+  "category": "auth",
+  "tags": ["lancers", "2fa", "login"],
+  "source_thread_id": "uuid"
+}
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `project_id` | string | Yes | プロジェクト UUID |
+| `title` | string | Yes | 知見のタイトル |
+| `content` | string | Yes | 知見の内容 |
+| `category` | string | Yes | `auth`, `environment`, `know-how`, `decision`, `preference` |
+| `tags` | string[] | No | 自由タグ（検索用） |
+| `source_thread_id` | string | No | 知見の出典ヘルプスレッド UUID |
+
+**推奨ワークフロー:**
+1. ブロッカー発生 → `GET /api/project-memories?project_id=...&category=auth&search=2fa` で既知の知見を検索
+2. 該当あり → 知見に基づいて自己解決 or 即エスカレーション
+3. 該当なし → `POST /api/help-threads` でブロッカー起票
+4. 解決後 → `POST /api/project-memories` で知見を蓄積
+
 ### Commands
 
 | Method | Endpoint | Description |
@@ -601,3 +769,30 @@ Response:
 | POST | `/api/minion/skills` | スキル登録/更新（新バージョン自動作成） |
 
 スキルはバージョン管理される。push ごとに新バージョンが作成され、ファイルは Supabase Storage に保存される。
+
+### Help Threads (HQ)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/minion/help-threads` | ブロッカースレッドを起票 |
+| GET | `/api/minion/help-threads/open` | 参加プロジェクトの未解決スレッド一覧 |
+| GET | `/api/minion/help-threads/:id` | スレッド詳細 + メッセージ一覧 |
+| POST | `/api/minion/help-threads/:id/messages` | スレッドにメッセージを投稿 |
+| PATCH | `/api/minion/help-threads/:id/resolve` | スレッドを解決済みにする。Body: `{resolution}` |
+| PATCH | `/api/minion/help-threads/:id/cancel` | スレッドをキャンセル。Body: `{reason?}` |
+| DELETE | `/api/minion/help-threads/:id` | スレッドを完全削除（PMのみ）。メッセージもCASCADE削除 |
+| PATCH | `/api/minion/help-threads/:id/escalate` | スレッドを手動エスカレーション |
+
+ローカルエージェントの `/api/help-threads` は上記 HQ API へのプロキシ。
+詳細なリクエスト/レスポンス仕様はローカル API セクションの「Help Threads」を参照。
+
+### Project Memories (HQ)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/minion/project-memories` | プロジェクトメモリーを投稿 |
+| GET | `/api/minion/project-memories` | メモリー検索。Query: `?project_id=&search=&category=&tags=&status=` |
+| PATCH | `/api/minion/project-memories/:id` | メモリーを更新。Body: `{title?, content?, category?, tags?, status?}` |
+
+ローカルエージェントの `/api/project-memories` は上記 HQ API へのプロキシ。
+詳細なリクエスト/レスポンス仕様はローカル API セクションの「Project Memories」を参照。

package/docs/environment-setup.md

@@ -28,9 +28,20 @@ requires:
 
 ## MCP サーバーの設定
 
-MCP サーバーは `~/.mcp.json` に JSON 形式で設定する。このファイルが Claude Code セッション起動時に読み込まれる。
+MCPサーバーの設定ファイルは使用するCLIツールによって異なる。
+いずれも LLM から直接編集可能（パーミッション設定とは異なり、API経由は不要）。
 
-### ファイル形式
+### CLI別の設定ファイル
+
+| CLI | 設定ファイル | フォーマット | 編集方法 |
+|-----|------------|------------|---------|
+| Claude Code | `.mcp.json`（プロジェクトルート） | JSON | Edit/Write ツールで直接編集 |
+| Gemini CLI | `.gemini/settings.json` | JSON | Edit/Write ツールで直接編集 |
+| Codex CLI | `~/.codex/config.toml` | TOML | `codex mcp add/remove` コマンド推奨 |
+
+### Claude Code
+
+設定ファイル: `.mcp.json`（プロジェクトルート）または `~/.mcp.json`（ユーザーレベル）
 
 ```json
 {
@@ -43,9 +54,8 @@ MCP サーバーは `~/.mcp.json` に JSON 形式で設定する。このファ
 }
 ```
 
-### 設定の追加・変更手順
-
-1. `~/.mcp.json` が存在しない場合は新規作成する
+**設定の追加・変更手順:**
+1. `.mcp.json` が存在しない場合は新規作成する
 2. 既存の場合は内容を読み取り、`mcpServers` オブジェクトにエントリを追加する
 3. 既存エントリを壊さないよう注意する
 
@@ -54,10 +64,54 @@ MCP サーバーは `~/.mcp.json` に JSON 形式で設定する。このファ
 cat ~/.mcp.json 2>/dev/null || echo '(not found)'
 ```
 
+**スコープの優先順:**
+1. ローカル (`~/.claude.json` 内のプロジェクト固有設定) — 最優先
+2. プロジェクト (`.mcp.json`) — チーム共有
+3. ユーザー (`~/.claude.json`) — 全プロジェクト共通
+
+### Gemini CLI
+
+設定ファイル: `.gemini/settings.json`（プロジェクト）または `~/.gemini/settings.json`（ユーザーレベル）
+
+```json
+{
+  "mcpServers": {
+    "<server-name>": {
+      "command": "<起動コマンド>",
+      "args": ["<引数1>", "<引数2>"],
+      "timeout": 30000
+    }
+  }
+}
+```
+
+追加フィールド: `cwd`（作業ディレクトリ）、`timeout`（ミリ秒）、`trust`（確認プロンプト省略）、`includeTools`/`excludeTools`（ツールフィルタ）
+
+### Codex CLI
+
+設定ファイル: `.codex/config.toml`（プロジェクト）または `~/.codex/config.toml`（ユーザーレベル）
+
+```toml
+[mcp_servers.<server-name>]
+command = "<起動コマンド>"
+args = ["<引数1>", "<引数2>"]
+startup_timeout_sec = 10.0
+tool_timeout_sec = 60.0
+```
+
+**注意:** `.codex/` ディレクトリは LLM からの直接編集が制限される場合がある。以下のコマンドを使用すること:
+
+```bash
+codex mcp add <name> --command "<command>" --args "<arg1>,<arg2>"
+codex mcp remove <name>
+codex mcp list
+```
+
 ### よく使う MCP サーバーの設定例
 
 #### Playwright（ブラウザ自動化）
 
+**Claude Code / Gemini CLI:**
 ```json
 {
   "mcpServers": {
@@ -69,10 +123,18 @@ cat ~/.mcp.json 2>/dev/null || echo '(not found)'
 }
 ```
 
+**Codex CLI:**
+```toml
+[mcp_servers.playwright]
+command = "npx"
+args = ["-y", "@playwright/mcp@latest"]
+```
+
 `npx -y` により、未インストールでも自動ダウンロード・実行される。事前の `npm install` は不要。
 
 #### Supabase（データベース）
 
+**Claude Code / Gemini CLI:**
 ```json
 {
   "mcpServers": {
@@ -83,14 +145,20 @@ cat ~/.mcp.json 2>/dev/null || echo '(not found)'
 }
 ```
 
+**Codex CLI:**
+```toml
+[mcp_servers.supabase]
+url = "http://<supabase-host>:54321/mcp?read_only=true&features=database,docs"
+```
+
 URL ベースの MCP サーバーは `url` フィールドで指定する（`command`/`args` は不要）。
 
 ### 注意事項
 
-- `~/.mcp.json` は手動で編集する。Claude Code の設定 UI からは変更できない
+- MCP設定ファイルはLLMから直接編集できる（パーミッション設定ファイルとは異なり書き込み保護がない）
 - `npx -y <package>` 形式を使えば、グローバルインストールなしで MCP サーバーを起動できる
 - サーバー名はスキルの `requires.mcp_servers` と一致させる必要がある（例: `playwright`）
-- `claude-settings.json`（`~/.claude/settings.json`）の `mcpServers` に設定しても同様に動作するが、`~/.mcp.json` が推奨
+- Claude Code では `.mcp.json`（プロジェクトルート）が推奨。`~/.claude/settings.json` の `mcpServers` には設定しない
 
 ---
 

package/linux/minion-cli.sh

@@ -12,6 +12,7 @@
 #   sudo minion-cli restart                  # Restart agent service (root)
 #   minion-cli status                        # Get current status
 #   minion-cli health                        # Health check
+#   minion-cli daemons                       # Daemon status
 #   minion-cli diagnose                      # Run full service diagnostics
 #   minion-cli set-status busy "Running X"   # Set status and task
 #   minion-cli set-status online             # Set status only
@@ -814,6 +815,7 @@ CFEOF
   echo "Useful commands:"
   echo "  minion-cli status                     # Agent status"
   echo "  minion-cli health                     # Health check"
+  echo "  minion-cli daemons                    # Daemon status"
   echo "  sudo minion-cli restart               # Restart agent"
   echo "  sudo minion-cli stop                  # Stop agent"
   if [ "$PROC_MGR" = "systemd" ]; then
@@ -1219,6 +1221,10 @@ case "${1:-}" in
     curl -s "$AGENT_URL/api/health" | jq .
     ;;
 
+  daemons)
+    curl -s "$AGENT_URL/api/daemons/status" | jq .
+    ;;
+
   diagnose)
     echo "Running diagnostics..."
     echo ""

package/linux/server.js

@@ -43,6 +43,7 @@ const routineStore = require('../core/stores/routine-store')
 // Heartbeat interval: fixed at 30s (not user-configurable)
 const HEARTBEAT_INTERVAL_MS = 30_000
 let heartbeatTimer = null
+let lastBeatAt = null
 
 // Linux-specific modules
 const workflowRunner = require('./workflow-runner')
@@ -50,10 +51,14 @@ const routineRunner = require('./routine-runner')
 const { cleanupTtyd, killStaleTtydProcesses } = require('./routes/terminal')
 const { startTerminalProxy, stopTerminalProxy } = require('./terminal-proxy')
 
+// Config warnings (included in heartbeat)
+const { getConfigWarnings } = require('../core/lib/config-warnings')
+
 // Pull-model daemons (from core/)
 const stepPoller = require('../core/lib/step-poller')
 const revisionWatcher = require('../core/lib/revision-watcher')
 const reflectionScheduler = require('../core/lib/reflection-scheduler')
+const threadWatcher = require('../core/lib/thread-watcher')
 const runningTasks = require('../core/lib/running-tasks')
 
 // Shared routes (from core/)
@@ -68,6 +73,8 @@ const { memoryRoutes } = require('../core/routes/memory')
 const { dailyLogRoutes } = require('../core/routes/daily-logs')
 const { sudoersRoutes } = require('../core/routes/sudoers')
 const { permissionRoutes } = require('../core/routes/permissions')
+const { helpThreadRoutes } = require('../core/routes/help-threads')
+const { daemonRoutes } = require('../core/routes/daemons')
 
 // Linux-specific routes
 const { commandRoutes, getProcessManager, getAllowedCommands } = require('./routes/commands')
@@ -113,6 +120,7 @@ async function shutdown(signal) {
   stepPoller.stop()
   revisionWatcher.stop()
   reflectionScheduler.stop()
+  threadWatcher.stop()
   workflowRunner.stopAll()
   routineRunner.stopAll()
 
@@ -270,6 +278,8 @@ async function registerAllRoutes(app) {
   await app.register(dailyLogRoutes)
   await app.register(sudoersRoutes)
   await app.register(permissionRoutes)
+  await app.register(helpThreadRoutes)
+  await app.register(daemonRoutes, { heartbeatStatus: () => ({ running: !!heartbeatTimer, last_beat_at: lastBeatAt }) })
 
   // Linux-specific routes
   await app.register(commandRoutes)
@@ -353,14 +363,16 @@ async function start() {
       // Send initial online heartbeat
       const { getStatus } = require('../core/routes/health')
       const { currentTask } = getStatus()
-      sendHeartbeat({ status: 'online', current_task: currentTask, running_tasks: runningTasks.getAll(), version }).catch(err => {
+      sendHeartbeat({ status: 'online', current_task: currentTask, running_tasks: runningTasks.getAll(), config_warnings: getConfigWarnings(), version }).catch(err => {
         console.error('[Heartbeat] Initial heartbeat failed:', err.message)
       })
 
       // Start periodic heartbeat
       heartbeatTimer = setInterval(() => {
         const { currentStatus, currentTask } = getStatus()
-        sendHeartbeat({ status: currentStatus, current_task: currentTask, running_tasks: runningTasks.getAll(), version }).catch(err => {
+        sendHeartbeat({ status: currentStatus, current_task: currentTask, running_tasks: runningTasks.getAll(), config_warnings: getConfigWarnings(), version }).then(() => {
+          lastBeatAt = new Date().toISOString()
+        }).catch(err => {
           console.error('[Heartbeat] Periodic heartbeat failed:', err.message)
         })
       }, HEARTBEAT_INTERVAL_MS)
@@ -369,6 +381,7 @@ async function start() {
       // Start Pull-model daemons
       stepPoller.start()
       revisionWatcher.start()
+      threadWatcher.start(runQuickLlmCall)
     } else {
       console.log('[Server] Running in standalone mode (no HQ connection)')
     }

package/package.json

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

package/rules/core.md

@@ -67,6 +67,51 @@ curl -X POST -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application
 
 対応CLI: `claude-code` (.claude/settings.local.json), `gemini` (.gemini/settings.json), `codex` (.codex/config.toml)
 
+#### MCP Server Configuration
+
+MCPサーバーの設定は各CLIの設定ファイルを直接編集して行う（APIは不要）。
+パーミッション（allow/deny）とは異なり、MCP設定ファイルはLLMから直接編集可能。
+
+| CLI | 設定ファイル | 編集方法 |
+|-----|------------|---------|
+| Claude Code | `.mcp.json`（プロジェクトルート） | 直接編集（Write/Edit ツール） |
+| Gemini CLI | `.gemini/settings.json` | 直接編集 |
+| Codex CLI | `.codex/config.toml` | `codex mcp add/remove` コマンドを使用 |
+
+**Claude Code** — `.mcp.json` を編集:
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    }
+  }
+}
+```
+
+**Gemini CLI** — `.gemini/settings.json` の `mcpServers` を編集:
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"],
+      "timeout": 30000
+    }
+  }
+}
+```
+
+**Codex CLI** — `codex mcp add` コマンド、または `~/.codex/config.toml` を編集:
+```toml
+[mcp_servers.playwright]
+command = "npx"
+args = ["-y", "@playwright/mcp@latest"]
+```
+
+Note: Codex CLI の `.codex/` ディレクトリはLLMからの直接編集が制限される場合がある。その場合は `codex mcp add` コマンドを使用すること。
+
 ### HQ API
 
 `$HQ_URL/api/minion/*` — 認証: `Authorization: Bearer $API_TOKEN`