@geekbeer/minion 2.70.2 → 3.4.7

package/linux/routes/chat.js

@@ -85,7 +85,7 @@ async function chatRoutes(fastify) {
       return { success: false, error: 'Unauthorized' }
     }
 
-    const session = await chatStore.load()
+    const session = chatStore.load()
     if (!session) {
       return { success: true, session: null }
     }
@@ -95,12 +95,41 @@ async function chatRoutes(fastify) {
       session: {
         session_id: session.session_id,
         messages: session.messages,
+        turn_count: session.turn_count,
         created_at: session.created_at,
         updated_at: session.updated_at,
       },
     }
   })
 
+  // GET /api/chat/sessions - List all sessions (metadata only)
+  fastify.get('/api/chat/sessions', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    const limit = parseInt(request.query?.limit) || 50
+    const sessions = chatStore.listSessions(limit)
+    return { success: true, sessions }
+  })
+
+  // GET /api/chat/sessions/:sessionId - Get a specific session with messages
+  fastify.get('/api/chat/sessions/:sessionId', async (request, reply) => {
+    if (!verifyToken(request)) {
+      reply.code(401)
+      return { success: false, error: 'Unauthorized' }
+    }
+
+    const session = chatStore.loadById(request.params.sessionId)
+    if (!session) {
+      reply.code(404)
+      return { success: false, error: 'Session not found' }
+    }
+
+    return { success: true, session }
+  })
+
   // POST /api/chat/clear - Clear the active session
   fastify.post('/api/chat/clear', async (request, reply) => {
     if (!verifyToken(request)) {
@@ -204,16 +233,34 @@ async function chatRoutes(fastify) {
 async function buildContextPrefix(message, context, sessionId) {
   const parts = []
 
-  // Tell the LLM where to find memory and daily logs (content is NOT injected)
+  // Tell the LLM how to access memory and daily logs via API
   if (!sessionId) {
-    const memoryDir = require('path').join(DATA_DIR, 'memory')
-    const dailyLogDir = require('path').join(DATA_DIR, 'daily-logs')
+    const port = require('../../core/config').config.AGENT_PORT
+    const baseUrl = `http://localhost:${port}`
     parts.push(
       '[長期記憶・デイリーログについて]',
       'あなたには長期記憶（メモリ）とデイリーログがあります。内容は毎回読み込まれません。',
-      '必要なときだけ以下のファイルを読んで参照してください：',
-      `- メモリ索引: ${memoryDir}/MEMORY.md（概要一覧。詳細は個別の .md ファイルを読む）`,
-      `- デイリーログ: ${dailyLogDir}/YYYY-MM-DD.md（日付別の作業記録）`,
+      '必要なときは以下のAPIで検索・取得してください（認証ヘッダー必須）：',
+      '',
+      '```bash',
+      '# メモリ検索（キーワードで全文検索）',
+      `curl -H "Authorization: Bearer $API_TOKEN" "${baseUrl}/api/memory?search=キーワード"`,
+      '',
+      '# メモリ一覧',
+      `curl -H "Authorization: Bearer $API_TOKEN" ${baseUrl}/api/memory`,
+      '',
+      '# メモリ詳細（IDを指定）',
+      `curl -H "Authorization: Bearer $API_TOKEN" ${baseUrl}/api/memory/{id}`,
+      '',
+      '# デイリーログ検索',
+      `curl -H "Authorization: Bearer $API_TOKEN" "${baseUrl}/api/daily-logs?search=キーワード"`,
+      '',
+      '# デイリーログ一覧',
+      `curl -H "Authorization: Bearer $API_TOKEN" ${baseUrl}/api/daily-logs`,
+      '',
+      '# 特定日のデイリーログ取得',
+      `curl -H "Authorization: Bearer $API_TOKEN" ${baseUrl}/api/daily-logs/YYYY-MM-DD`,
+      '```',
       '',
       '参照すべきタイミング:',
       '- 過去の作業や決定事項を思い出す必要があるとき',

package/linux/server.js

@@ -128,7 +128,9 @@ async function shutdown(signal) {
   stopTerminalProxy()
   cleanupTtyd()
 
-  // Close server
+  // Close database and server
+  const { closeDb } = require('../core/db')
+  closeDb()
   await fastify.close()
   process.exit(0)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "2.70.2",
+  "version": "3.4.7",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {
@@ -25,6 +25,7 @@
     "start:win": "node win/server.js"
   },
   "dependencies": {
+    "better-sqlite3": "^11.0.0",
     "croner": "^9.0.0",
     "fastify": "^5.2.2",
     "ws": "^8.0.0"
@@ -33,7 +34,7 @@
     "node-pty": "^1.0.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "publishConfig": {
     "access": "public"

package/roles/engineer.md

@@ -23,6 +23,18 @@
 
 詳細な手順は `~/.minion/docs/task-guides.md` を参照。
 
+## ブロッカー対処
+
+スキル実行中に自力で解決できない問題に遭遇した場合:
+
+1. **まずプロジェクトメモリーを検索** — `GET /api/project-memories?project_id=...&search=キーワード` で過去の知見を確認
+2. **自己解決不可なら即ヘルプスレッドを起票** — `POST /api/threads` で `thread_type: "help"` を作成。`attempted_resolution` に試したことを記載
+3. **人間にしか解決できない問題は `mentions: ["user"]` で即エスカレーション** — 認証コード、パスワード、外部承認など
+4. **解決後はスレッドを resolve し、知見をプロジェクトメモリーに保存**
+
+**スキルを失敗終了させる前に、必ずヘルプスレッドでエスカレーションすること。**
+詳細は `~/.minion/rules/core.md` の「Blocker Handling」セクションを参照。
+
 ## 実行コンテキスト
 
 ミニオン変数・シークレット（HQ UIまたはAPI経由で設定）はサーバー起動時に `process.env` にロードされ、ワークフロー実行中も利用可能。

package/roles/pm.md

@@ -42,6 +42,22 @@ HQのDBがステートマシンとして状態を管理し、ミニオン間の
 - `GET /api/minion/me/project/[id]/context` でコンテキスト取得
 - `PUT /api/minion/me/project/[id]/context` でコンテキスト更新（PMのみ）
 
+## ブロッカー対処
+
+PMとして、ブロッカーの解決を主導する責務がある:
+
+### 自分がブロッカーに遭遇した場合
+1. **プロジェクトメモリーを検索** — 過去の知見で解決できないか確認
+2. **自己解決不可なら `mentions: ["user"]` でヘルプスレッドを起票** — PMが解決できない問題は人間にエスカレーション
+3. **解決後はスレッドを resolve し、知見をプロジェクトメモリーに保存**
+
+### エンジニアからのヘルプスレッドに対応する場合
+1. **thread_watcher が自動で通知するので、`role:pm` 宛のスレッドに回答する**
+2. **自分で解決できない場合は `@user` メンション付きで人間にエスカレーション**
+3. **解決策が汎用的なら、プロジェクトメモリーへの保存を促す**
+
+詳細は `~/.minion/rules/core.md` の「Blocker Handling」セクションを参照。
+
 ## Routine (従来方式)
 
 ワークフローは `project-workflow-check` スキルを通じてルーティンからも実行可能:

package/rules/core.md

@@ -157,6 +157,72 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 - `pm.md` — PM (Project Manager) のガイドライン
 - `engineer.md` — Engineer のガイドライン
 
+## Blocker Handling (ブロッカー対処)
+
+タスク実行中にブロッカー（自力で解決できない問題）に遭遇した場合、以下のフローに従うこと。
+**ブロッカーを放置してタスクを失敗終了させてはならない。** 必ずエスカレーションすること。
+
+### ブロッカーの判断基準
+
+以下のいずれかに該当する場合、ブロッカーとして対処する:
+- 認証情報・アクセス権限が不足している（2FA、APIキー、ログイン情報等）
+- 外部サービスがエラーを返し、リトライしても解決しない
+- 必要な情報やファイルが見つからず、推測では進められない
+- 人間の判断・承認が必要（デプロイ承認、契約内容の確認等）
+- 環境の問題（サービスダウン、ネットワークエラー等）で作業を継続できない
+
+### 対処フロー
+
+```
+1. プロジェクトメモリーを検索（過去に同じ問題が解決済みか確認）
+   GET /api/project-memories?project_id=...&category=...&search=キーワード
+
+2-a. 該当する知見あり → 知見に基づいて自己解決を試みる
+
+2-b. 該当なし or 自己解決不可 → ヘルプスレッドを起票
+   POST /api/threads
+   {
+     "project_id": "...",
+     "thread_type": "help",
+     "title": "問題の要約（1行）",
+     "content": "状況の詳細説明",
+     "mentions": ["role:pm"],
+     "context": {
+       "category": "auth|environment|external-service|information|approval",
+       "attempted_resolution": "試行した内容"
+     }
+   }
+
+3. スレッドの返信を待つ（thread_watcher が自動監視）
+
+4. 解決後 → プロジェクトメモリーに知見を保存
+   POST /api/project-memories
+   {
+     "project_id": "...",
+     "title": "知見タイトル",
+     "content": "解決方法の詳細",
+     "category": "know-how",
+     "source_thread_id": "スレッドUUID"
+   }
+```
+
+### メンションの使い分け
+
+| 状況 | メンション |
+|------|-----------|
+| PMに判断を仰ぐ | `["role:pm"]` |
+| エンジニアの知見が必要 | `["role:engineer"]` |
+| 特定ミニオンに聞く | `["minion:<minion_id>"]` |
+| 人間の介入が必要（認証コード、承認等） | `["user"]` |
+| チーム全体に共有 | `[]`（メンションなし） |
+
+### 重要なルール
+
+- **スレッド起票時は `attempted_resolution` を必ず含める。** 何を試したか不明だと、回答者が同じことを提案してしまう。
+- **人間にしか解決できない問題（認証コード入力、外部サービスのパスワード等）は即 `@user` メンション**で起票する。自己解決を試みて時間を浪費しないこと。
+- **ブロッカーが解決したらスレッドを `resolve` する。** 放置しない。
+- **解決策をプロジェクトメモリーに保存する。** 同じブロッカーに再度遭遇する他のミニオンの助けになる。
+
 ## Documentation
 
 API仕様やタスク手順の詳細は以下を参照: