@geekbeer/minion 2.68.5 → 2.70.2

package/core/api.js

@@ -88,75 +88,75 @@ async function sendHeartbeat(data) {
 
 /**
  * Create a project thread (help or discussion) on HQ.
- * @param {object} data - { project_id, title, description, thread_type?, mentions?, context? }
+ * @param {object} data - { project_id, title, content, thread_type?, mentions?, context? }
  * @returns {Promise<{ thread: object }>}
  */
-async function createHelpThread(data) {
-  return request('/help-threads', {
+async function createThread(data) {
+  return request('/threads', {
     method: 'POST',
     body: JSON.stringify(data),
   })
 }
 
 /**
- * Get open help threads in this minion's projects.
+ * Get open threads in this minion's projects.
  * @returns {Promise<{ threads: object[] }>}
  */
-async function getOpenHelpThreads() {
-  return request('/help-threads/open')
+async function getOpenThreads() {
+  return request('/threads/open')
 }
 
 /**
- * Get a help thread by ID with messages.
+ * Get a thread by ID with messages.
  * @param {string} threadId
  * @returns {Promise<{ thread: object, messages: object[] }>}
  */
-async function getHelpThread(threadId) {
-  return request(`/help-threads/${threadId}`)
+async function getThread(threadId) {
+  return request(`/threads/${threadId}`)
 }
 
 /**
- * Post a message to a help thread.
+ * Post a message to a thread.
  * @param {string} threadId
  * @param {object} data - { content, attachments?, mentions? }
  */
-async function postHelpMessage(threadId, data) {
-  return request(`/help-threads/${threadId}/messages`, {
+async function postThreadMessage(threadId, data) {
+  return request(`/threads/${threadId}/messages`, {
     method: 'POST',
     body: JSON.stringify(data),
   })
 }
 
 /**
- * Resolve a help thread.
+ * Resolve a thread.
  * @param {string} threadId
  * @param {string} resolution
  */
-async function resolveHelpThread(threadId, resolution) {
-  return request(`/help-threads/${threadId}/resolve`, {
+async function resolveThread(threadId, resolution) {
+  return request(`/threads/${threadId}/resolve`, {
     method: 'PATCH',
     body: JSON.stringify({ resolution }),
   })
 }
 
 /**
- * Cancel a help thread.
+ * Cancel a thread.
  * @param {string} threadId
  * @param {string} [reason]
  */
-async function cancelHelpThread(threadId, reason) {
-  return request(`/help-threads/${threadId}/cancel`, {
+async function cancelThread(threadId, reason) {
+  return request(`/threads/${threadId}/cancel`, {
     method: 'PATCH',
     body: JSON.stringify({ reason: reason || null }),
   })
 }
 
 /**
- * Permanently delete a help thread (PM only).
+ * Permanently delete a thread (PM only).
  * @param {string} threadId
  */
-async function deleteHelpThread(threadId) {
-  return request(`/help-threads/${threadId}`, {
+async function deleteThread(threadId) {
+  return request(`/threads/${threadId}`, {
     method: 'DELETE',
   })
 }
@@ -192,14 +192,13 @@ module.exports = {
   reportStepComplete,
   reportIssue,
   sendHeartbeat,
-  createHelpThread,
-  getOpenHelpThreads,
-  getHelpThread,
-  postHelpMessage,
-  resolveHelpThread,
-
-  cancelHelpThread,
-  deleteHelpThread,
+  createThread,
+  getOpenThreads,
+  getThread,
+  postThreadMessage,
+  resolveThread,
+  cancelThread,
+  deleteThread,
   createProjectMemory,
   searchProjectMemories,
 }

package/core/lib/thread-watcher.js

@@ -10,7 +10,7 @@
  * 3. Rate limiting: max 1 LLM evaluation per thread per 5 minutes
  *
  * Flow per poll cycle:
- * 1. GET /api/minion/help-threads/open → list of open threads
+ * 1. GET /api/minion/threads/open → list of open threads
  * 2. For each thread with new activity:
  *    a. Check mentions → if mentioned, must evaluate
  *    b. Check read state → skip if no new messages
@@ -98,7 +98,7 @@ async function pollOnce() {
 
   polling = true
   try {
-    const data = await api.request('/help-threads/open')
+    const data = await api.request('/threads/open')
 
     if (!data.threads || data.threads.length === 0) {
       return
@@ -139,7 +139,7 @@ async function processThread(thread, myProjects, now) {
   // Fetch thread detail to get message count and check for new messages
   let detail
   try {
-    detail = await api.request(`/help-threads/${thread.id}`)
+    detail = await api.request(`/threads/${thread.id}`)
   } catch {
     return
   }
@@ -155,6 +155,13 @@ async function processThread(thread, myProjects, now) {
   // New messages detected
   const newMessages = messages.slice(state.lastMessageCount)
 
+  // Skip if all new messages are from self (avoid re-triggering on own posts)
+  const newFromOthers = newMessages.filter(m => m.sender_minion_id !== config.MINION_ID)
+  if (newFromOthers.length === 0) {
+    readState.set(thread.id, { ...state, lastMessageCount: messageCount })
+    return
+  }
+
   // Update read state (message count only — eval timestamp updated after LLM call)
   readState.set(thread.id, { ...state, lastMessageCount: messageCount })
 
@@ -194,9 +201,9 @@ async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMess
     .join('\n')
 
   const threadType = threadDetail.thread_type || 'help'
-  const mentionNote = mentioned
-    ? '\n\nあなたはこのスレッドでメンションされています。必ず返信してください。'
-    : ''
+  const isRequester = threadDetail.requester_minion_id === config.MINION_ID
+  const mentions = threadDetail.mentions || []
+  const mentionsSummary = mentions.length > 0 ? mentions.join(', ') : 'なし（全員に向けた投稿）'
 
   // Extract optional context metadata
   const ctx = threadDetail.context || {}
@@ -205,13 +212,14 @@ async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMess
     ctx.attempted_resolution ? `試行済み: ${ctx.attempted_resolution}` : '',
   ].filter(Boolean).join('\n')
 
-  const prompt = `あなたはプロジェクト「${myProject.name}」のチームメンバー（ロール: ${myProject.role}）です。
+  const prompt = `あなたはプロジェクト「${myProject.name}」のチームメンバー（ロール: ${myProject.role}、ID: ${config.MINION_ID}）です。
 以下のスレッドに対して、あなたが返信すべきかどうかを判断し、返信する場合はその内容を生成してください。
 
 スレッドタイプ: ${threadType}
 タイトル: ${threadDetail.title}
-説明: ${threadDetail.description}
-${contextInfo}${mentionNote}
+起票者: ${isRequester ? 'あなた自身' : `他のミニオン(${threadDetail.requester_minion_id?.slice(0, 8)})`}
+メンション対象: ${mentionsSummary}
+${contextInfo}
 
 --- メッセージ履歴 ---
 ${messageHistory || '(メッセージなし)'}
@@ -225,11 +233,15 @@ ${messageHistory || '(メッセージなし)'}
 }
 
 判断基準:
+- 自分が起票したスレッドの場合、他のメンバーの回答を待つべき（追加情報がある場合を除く）
+- メンション対象が特定のロールやミニオンに限定されている場合、自分が対象でなければ静観する
 - 自分のロール（${myProject.role}）に関連する話題か
 - 自分が貢献できる知見や意見があるか
 - 既に十分な回答がある場合は重複を避ける
-- メンションされている場合は必ず返信する
-- 人間に聞くべき場合は @user メンションを含めて返信する`
+- 人間に聞くべき場合は @user メンションを含めて返信する
+
+フォーマットルール:
+- 他のミニオンに言及する場合は必ず Minion(IDの先頭8文字) の形式を使うこと（例: メッセージ履歴中の Minion(abc12345) をそのまま使用）`
 
   try {
     const result = await llmCallFn(prompt)
@@ -251,7 +263,7 @@ ${messageHistory || '(メッセージなし)'}
         mentions.push('user')
       }
 
-      await api.request(`/help-threads/${threadSummary.id}/messages`, {
+      await api.request(`/threads/${threadSummary.id}/messages`, {
         method: 'POST',
         body: JSON.stringify({
           content: parsed.response,
@@ -281,7 +293,7 @@ async function fallbackMemoryMatch(thread) {
 
     if (!memData.memories || memData.memories.length === 0) return
 
-    const keywords = (thread.title + ' ' + thread.description)
+    const keywords = thread.title
       .toLowerCase()
       .split(/[\s,.\-_/]+/)
       .filter(w => w.length >= 3)
@@ -301,7 +313,7 @@ async function fallbackMemoryMatch(thread) {
       .map(m => `[${m.title}] ${m.content}`)
       .join('\n\n')
 
-    await api.request(`/help-threads/${thread.id}/messages`, {
+    await api.request(`/threads/${thread.id}/messages`, {
       method: 'POST',
       body: JSON.stringify({
         content: `関連するプロジェクトメモリーが見つかりました:\n\n${knowledgeSummary}`,

package/core/routes/{help-threads.js → threads.js}

@@ -2,13 +2,13 @@
  * 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/threads         - List open threads in minion's projects
+ * - POST /api/threads         - Create a new thread (proxied to HQ)
+ * - GET  /api/threads/:id     - Get thread detail with messages
+ * - POST /api/threads/:id/messages  - Post a message to a thread
+ * - POST /api/threads/:id/resolve   - Resolve a thread
+ * - POST /api/threads/:id/cancel    - Cancel a thread
+ * - DELETE /api/threads/:id   - Permanently delete a thread (PM only)
  * - GET  /api/project-memories     - Search project memories
  * - POST /api/project-memories     - Create a project memory
  */
@@ -19,77 +19,77 @@ const api = require('../api')
 /**
  * @param {import('fastify').FastifyInstance} fastify
  */
-async function helpThreadRoutes(fastify) {
+async function threadRoutes(fastify) {
   // List open threads
-  fastify.get('/api/help-threads', async (request, reply) => {
+  fastify.get('/api/threads', async (request, reply) => {
     if (!verifyToken(request)) {
       reply.code(401)
       return { success: false, error: 'Unauthorized' }
     }
 
     try {
-      const data = await api.getOpenHelpThreads()
+      const data = await api.getOpenThreads()
       return { success: true, threads: data.threads || [] }
     } catch (error) {
-      console.error(`[HelpThreads] List error: ${error.message}`)
+      console.error(`[Threads] List error: ${error.message}`)
       reply.code(500)
       return { success: false, error: error.message }
     }
   })
 
   // Create thread
-  fastify.post('/api/help-threads', async (request, reply) => {
+  fastify.post('/api/threads', async (request, reply) => {
     if (!verifyToken(request)) {
       reply.code(401)
       return { success: false, error: 'Unauthorized' }
     }
 
     try {
-      const data = await api.createHelpThread(request.body)
+      const data = await api.createThread(request.body)
       return { success: true, thread: data.thread }
     } catch (error) {
-      console.error(`[HelpThreads] Create error: ${error.message}`)
+      console.error(`[Threads] 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) => {
+  fastify.get('/api/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)
+      const data = await api.getThread(request.params.id)
       return { success: true, thread: data.thread, messages: data.messages }
     } catch (error) {
-      console.error(`[HelpThreads] Get error: ${error.message}`)
+      console.error(`[Threads] 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) => {
+  fastify.post('/api/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)
+      const data = await api.postThreadMessage(request.params.id, request.body)
       return { success: true, message: data.message }
     } catch (error) {
-      console.error(`[HelpThreads] Message error: ${error.message}`)
+      console.error(`[Threads] 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) => {
+  fastify.post('/api/threads/:id/resolve', async (request, reply) => {
     if (!verifyToken(request)) {
       reply.code(401)
       return { success: false, error: 'Unauthorized' }
@@ -97,34 +97,34 @@ async function helpThreadRoutes(fastify) {
 
     try {
       const { resolution } = request.body || {}
-      const data = await api.resolveHelpThread(request.params.id, resolution)
+      const data = await api.resolveThread(request.params.id, resolution)
       return { success: true, thread: data.thread }
     } catch (error) {
-      console.error(`[HelpThreads] Resolve error: ${error.message}`)
+      console.error(`[Threads] 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) => {
+  fastify.delete('/api/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)
+      const data = await api.deleteThread(request.params.id)
       return { success: true, deleted: data.deleted }
     } catch (error) {
-      console.error(`[HelpThreads] Delete error: ${error.message}`)
+      console.error(`[Threads] 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) => {
+  fastify.post('/api/threads/:id/cancel', async (request, reply) => {
     if (!verifyToken(request)) {
       reply.code(401)
       return { success: false, error: 'Unauthorized' }
@@ -132,10 +132,10 @@ async function helpThreadRoutes(fastify) {
 
     try {
       const { reason } = request.body || {}
-      const data = await api.cancelHelpThread(request.params.id, reason)
+      const data = await api.cancelThread(request.params.id, reason)
       return { success: true, thread: data.thread }
     } catch (error) {
-      console.error(`[HelpThreads] Cancel error: ${error.message}`)
+      console.error(`[Threads] Cancel error: ${error.message}`)
       reply.code(error.statusCode || 500)
       return { success: false, error: error.message }
     }
@@ -186,4 +186,4 @@ async function helpThreadRoutes(fastify) {
   })
 }
 
-module.exports = { helpThreadRoutes }
+module.exports = { threadRoutes }

package/docs/api-reference.md

@@ -281,21 +281,21 @@ GET `/api/daemons/status` response:
 
 | 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 (ヘルプスレッド起票):
+| GET | `/api/threads` | 参加プロジェクトのオープンスレッド一覧 |
+| POST | `/api/threads` | スレッドを起票（初回メッセージを同時作成） |
+| GET | `/api/threads/:id` | スレッド詳細 + メッセージ一覧 |
+| POST | `/api/threads/:id/messages` | スレッドにメッセージを投稿 |
+| POST | `/api/threads/:id/resolve` | スレッドを解決済みにする |
+| POST | `/api/threads/:id/cancel` | スレッドをキャンセル |
+| DELETE | `/api/threads/:id` | スレッドを完全削除（PMのみ） |
+
+POST `/api/threads` body (ヘルプスレッド起票):
 ```json
 {
   "project_id": "uuid",
   "thread_type": "help",
   "title": "ランサーズの2FA認証コードが必要",
-  "description": "ログイン時に2段階認証を要求された。メールで届く6桁コードの入力が必要。",
+  "content": "ログイン時に2段階認証を要求された。メールで届く6桁コードの入力が必要。",
   "mentions": ["role:pm"],
   "context": {
     "category": "auth",
@@ -304,13 +304,13 @@ POST `/api/help-threads` body (ヘルプスレッド起票):
 }
 ```
 
-POST `/api/help-threads` body (ディスカッションスレッド起票):
+POST `/api/threads` body (ディスカッションスレッド起票):
 ```json
 {
   "project_id": "uuid",
   "thread_type": "discussion",
   "title": "デプロイ手順の確認",
-  "description": "本番デプロイ前にステージングで確認するフローに変えたい。意見ある？",
+  "content": "本番デプロイ前にステージングで確認するフローに変えたい。意見ある？",
   "mentions": ["role:engineer"]
 }
 ```
@@ -320,7 +320,7 @@ POST `/api/help-threads` body (ディスカッションスレッド起票):
 | `project_id` | string | Yes | プロジェクト UUID |
 | `thread_type` | string | No | `help`（デフォルト）or `discussion` |
 | `title` | string | Yes | スレッドの要約 |
-| `description` | string | Yes | 詳細説明 |
+| `content` | string | Yes | スレッド本文（thread_messagesの最初のメッセージとして保存） |
 | `mentions` | string[] | No | メンション対象。形式: `role:engineer`, `role:pm`, `minion:<minion_id>`, `user` |
 | `context` | object | No | 任意のメタデータ（category, urgency, workflow_execution_id等） |
 
@@ -334,7 +334,7 @@ POST `/api/help-threads` body (ディスカッションスレッド起票):
 - トークン消費を抑えるため、当事者が明確な場合はメンションを推奨
 - ミニオンが自力で解決できない場合、`@user` メンション付きで返信して人間に助けを求める
 
-POST `/api/help-threads/:id/messages` body:
+POST `/api/threads/:id/messages` body:
 ```json
 {
   "content": "関連するプロジェクトメモリーが見つかりました: ...",
@@ -348,14 +348,14 @@ POST `/api/help-threads/:id/messages` body:
 | `attachments` | object | No | 添付ファイル情報（JSON） |
 | `mentions` | string[] | No | メンション対象 |
 
-POST `/api/help-threads/:id/resolve` body:
+POST `/api/threads/:id/resolve` body:
 ```json
 {
   "resolution": "ユーザーから2FAコード(123456)を受け取りログイン成功"
 }
 ```
 
-POST `/api/help-threads/:id/cancel` body (optional):
+POST `/api/threads/:id/cancel` body (optional):
 ```json
 {
   "reason": "誤って起票したため取り消し"
@@ -409,7 +409,7 @@ POST `/api/project-memories` body:
 **推奨ワークフロー:**
 1. ブロッカー発生 → `GET /api/project-memories?project_id=...&category=auth&search=2fa` で既知の知見を検索
 2. 該当あり → 知見に基づいて自己解決 or 即エスカレーション
-3. 該当なし → `POST /api/help-threads` でブロッカー起票
+3. 該当なし → `POST /api/threads` でブロッカー起票
 4. 解決後 → `POST /api/project-memories` で知見を蓄積
 
 ### Commands
@@ -770,21 +770,20 @@ Response:
 
 スキルはバージョン管理される。push ごとに新バージョンが作成され、ファイルは Supabase Storage に保存される。
 
-### Help Threads (HQ)
+### Project 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」を参照。
+| POST | `/api/minion/threads` | スレッドを起票（初回メッセージを同時作成） |
+| GET | `/api/minion/threads/open` | 参加プロジェクトの未解決スレッド一覧 |
+| GET | `/api/minion/threads/:id` | スレッド詳細 + メッセージ一覧 |
+| POST | `/api/minion/threads/:id/messages` | スレッドにメッセージを投稿 |
+| PATCH | `/api/minion/threads/:id/resolve` | スレッドを解決済みにする。Body: `{resolution}` |
+| PATCH | `/api/minion/threads/:id/cancel` | スレッドをキャンセル。Body: `{reason?}` |
+| DELETE | `/api/minion/threads/:id` | スレッドを完全削除（PMのみ）。メッセージもCASCADE削除 |
+
+ローカルエージェントの `/api/threads` は上記 HQ API へのプロキシ。
+詳細なリクエスト/レスポンス仕様はローカル API セクションの「Project Threads」を参照。
 
 ### Project Memories (HQ)
 

package/linux/server.js

@@ -73,7 +73,7 @@ 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 { threadRoutes } = require('../core/routes/threads')
 const { daemonRoutes } = require('../core/routes/daemons')
 
 // Linux-specific routes
@@ -278,7 +278,7 @@ async function registerAllRoutes(app) {
   await app.register(dailyLogRoutes)
   await app.register(sudoersRoutes)
   await app.register(permissionRoutes)
-  await app.register(helpThreadRoutes)
+  await app.register(threadRoutes)
   await app.register(daemonRoutes, { heartbeatStatus: () => ({ running: !!heartbeatTimer, last_beat_at: lastBeatAt }) })
 
   // Linux-specific routes

package/package.json

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

package/win/server.js

@@ -57,7 +57,7 @@ const { variableRoutes } = require('../core/routes/variables')
 const { memoryRoutes } = require('../core/routes/memory')
 const { dailyLogRoutes } = require('../core/routes/daily-logs')
 const { permissionRoutes } = require('../core/routes/permissions')
-const { helpThreadRoutes } = require('../core/routes/help-threads')
+const { threadRoutes } = require('../core/routes/threads')
 const { daemonRoutes } = require('../core/routes/daemons')
 
 // Validate configuration
@@ -212,7 +212,7 @@ async function registerRoutes(app) {
   await app.register(memoryRoutes)
   await app.register(dailyLogRoutes)
   await app.register(permissionRoutes)
-  await app.register(helpThreadRoutes)
+  await app.register(threadRoutes)
   await app.register(daemonRoutes, { heartbeatStatus: () => ({ running: !!heartbeatTimer, last_beat_at: lastBeatAt }) })
 
   // Shutdown endpoint — allows detached restart/update scripts to trigger