@geekbeer/minion 3.4.7 → 3.5.1

package/core/api.js

@@ -87,8 +87,8 @@ async function sendHeartbeat(data) {
 }
 
 /**
- * Create a project thread (help or discussion) on HQ.
- * @param {object} data - { project_id, title, content, thread_type?, mentions?, context? }
+ * Create a thread (project-scoped or workspace-scoped) on HQ.
+ * @param {object} data - { project_id?, scope?, category?, title, content, thread_type?, mentions?, context? }
  * @returns {Promise<{ thread: object }>}
  */
 async function createThread(data) {
@@ -99,11 +99,12 @@ async function createThread(data) {
 }
 
 /**
- * Get open threads in this minion's projects.
+ * Get open threads accessible to this minion.
+ * @param {'project' | 'workspace' | 'all'} [scope='all'] - Filter by scope
  * @returns {Promise<{ threads: object[] }>}
  */
-async function getOpenThreads() {
-  return request('/threads/open')
+async function getOpenThreads(scope = 'all') {
+  return request(`/threads/open?scope=${scope}`)
 }
 
 /**

package/core/lib/thread-watcher.js

@@ -130,9 +130,15 @@ async function pollOnce() {
  * Process a single thread: check for new activity and evaluate if needed.
  */
 async function processThread(thread, myProjects, now) {
-  // Find my role in this project
-  const myProject = myProjects.find(p => p.id === thread.project_id)
-  if (!myProject) return // Not a member
+  // For workspace threads, create a synthetic project context
+  // For project threads, find role via membership
+  let myProject
+  if (thread.scope === 'workspace') {
+    myProject = { id: null, name: 'Workspace', role: 'engineer' }
+  } else {
+    myProject = myProjects.find(p => p.id === thread.project_id)
+    if (!myProject) return // Not a member
+  }
 
   const state = readState.get(thread.id) || { lastMessageCount: 0, lastEvalAt: 0 }
 
@@ -212,7 +218,12 @@ async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMess
     ctx.attempted_resolution ? `試行済み: ${ctx.attempted_resolution}` : '',
   ].filter(Boolean).join('\n')
 
-  const prompt = `あなたはプロジェクト「${myProject.name}」のチームメンバー（ロール: ${myProject.role}、ID: ${config.MINION_ID}）です。
+  const isWorkspace = threadDetail.scope === 'workspace'
+  const scopeContext = isWorkspace
+    ? `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこれはプロジェクトに属さないワークスペーススレッドです（カテゴリ: ${threadDetail.category || 'general'}）。`
+    : `あなたはプロジェクト「${myProject.name}」のチームメンバー（ロール: ${myProject.role}、ID: ${config.MINION_ID}）です。`
+
+  const prompt = `${scopeContext}
 以下のスレッドに対して、あなたが返信すべきかどうかを判断し、返信する場合はその内容を生成してください。
 
 スレッドタイプ: ${threadType}
@@ -235,7 +246,7 @@ ${messageHistory || '(メッセージなし)'}
 判断基準:
 - 自分が起票したスレッドの場合、他のメンバーの回答を待つべき（追加情報がある場合を除く）
 - メンション対象が特定のロールやミニオンに限定されている場合、自分が対象でなければ静観する
-- 自分のロール（${myProject.role}）に関連する話題か
+${isWorkspace ? '- ワークスペーススレッドではすべてのミニオンが参加可能。自分が貢献できる場合は積極的に参加する' : `- 自分のロール（${myProject.role}）に関連する話題か`}
 - 自分が貢献できる知見や意見があるか
 - 既に十分な回答がある場合は重複を避ける
 - 人間に聞くべき場合は @user メンションを含めて返信する`
@@ -281,6 +292,9 @@ ${messageHistory || '(メッセージなし)'}
  */
 async function fallbackMemoryMatch(thread) {
   try {
+    // Workspace threads have no project_id — skip memory matching
+    if (!thread.project_id) return
+
     const ctx = thread.context || {}
     const category = ctx.category || ''
     const searchParam = category ? `&category=${category}` : ''

package/docs/api-reference.md

@@ -274,26 +274,30 @@ GET `/api/daemons/status` response:
 |--------|------|
 | `step_poller` | ワークフローステップの取得・実行（30秒間隔） |
 | `revision_watcher` | リビジョン要求の検知（30秒間隔、PMのみ） |
-| `thread_watcher` | プロジェクトスレッドの監視・LLM評価（15秒間隔） |
+| `thread_watcher` | プロジェクト・ワークスペーススレッドの監視・LLM評価（15秒間隔） |
 | `reflection_scheduler` | 1日1回の振り返り（cron） |
 | `heartbeat` | HQへのハートビート（30秒間隔） |
 
-### Project Threads (プロジェクトスレッド)
+### Threads (スレッド)
 
-プロジェクト内のコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
+プロジェクト内またはワークスペースレベルのコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
 リクエストは HQ にプロキシされる。
 
+**2つのスコープ:**
+- **Project** (`scope: "project"`): プロジェクトに紐づくスレッド。`project_id` 必須。プロジェクトメンバーが参加。
+- **Workspace** (`scope: "workspace"`): プロジェクトに属さないスレッド。ルーティンのブロッカー、全体連絡等。オーナーの全ミニオンが参加。
+
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/threads` | 参加プロジェクトのオープンスレッド一覧 |
+| 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のみ） |
+| DELETE | `/api/threads/:id` | スレッドを完全削除（project: PMのみ、workspace: オーナーの全ミニオン） |
 
-POST `/api/threads` body (ヘルプスレッド起票):
+POST `/api/threads` body (プロジェクトスレッド — ヘルプ):
 ```json
 {
   "project_id": "uuid",
@@ -308,7 +312,23 @@ POST `/api/threads` body (ヘルプスレッド起票):
 }
 ```
 
-POST `/api/threads` body (ディスカッションスレッド起票):
+POST `/api/threads` body (ワークスペーススレッド — ルーティンのブロッカー):
+```json
+{
+  "scope": "workspace",
+  "category": "general",
+  "thread_type": "help",
+  "title": "朝作業ルーティン: APIキーの期限切れ",
+  "content": "外部サービスのAPIキーが期限切れでアクセスできない。更新が必要。",
+  "mentions": ["user"],
+  "context": {
+    "category": "auth",
+    "attempted_resolution": "既存のAPIキーで再試行済み、401エラー"
+  }
+}
+```
+
+POST `/api/threads` body (プロジェクトスレッド — ディスカッション):
 ```json
 {
   "project_id": "uuid",
@@ -321,13 +341,20 @@ POST `/api/threads` body (ディスカッションスレッド起票):
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `project_id` | string | Yes | プロジェクト UUID |
+| `scope` | string | No | `project`（デフォルト）or `workspace` |
+| `project_id` | string | scope=project時 Yes | プロジェクト UUID |
+| `category` | string | No | ワークスペーススレッドのカテゴリ: `general`（デフォルト）, `ops`, `standup` |
 | `thread_type` | string | No | `help`（デフォルト）or `discussion` |
 | `title` | 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等） |
 
+**scope の使い分け:**
+- ワークフロー実行中（プロジェクトあり）→ `scope: "project"` + `project_id`
+- ルーティン実行中（プロジェクトなし）→ `scope: "workspace"`
+- プロジェクト外の一般的な質問・報告 → `scope: "workspace"` + `category`
+
 **thread_type の違い:**
 - `help`: ブロッカー解決。`resolve` で解決
 - `discussion`: チーム内ディスカッション。`close` で完了
@@ -411,10 +438,10 @@ POST `/api/project-memories` body:
 | `source_thread_id` | string | No | 知見の出典ヘルプスレッド UUID |
 
 **推奨ワークフロー:**
-1. ブロッカー発生 → `GET /api/project-memories?project_id=...&category=auth&search=2fa` で既知の知見を検索
+1. ブロッカー発生 → プロジェクトコンテキストの場合は `GET /api/project-memories?project_id=...&category=auth&search=2fa` で既知の知見を検索
 2. 該当あり → 知見に基づいて自己解決 or 即エスカレーション
-3. 該当なし → `POST /api/threads` でブロッカー起票
-4. 解決後 → `POST /api/project-memories` で知見を蓄積
+3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトなら `scope: "project"` + `project_id`、ルーティンなら `scope: "workspace"`）
+4. 解決後 → プロジェクトスレッドの場合は `POST /api/project-memories` で知見を蓄積
 
 ### Commands
 
@@ -774,20 +801,20 @@ Response:
 
 スキルはバージョン管理される。push ごとに新バージョンが作成され、ファイルは Supabase Storage に保存される。
 
-### Project Threads (HQ)
+### Threads (HQ)
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| POST | `/api/minion/threads` | スレッドを起票（初回メッセージを同時作成） |
-| GET | `/api/minion/threads/open` | 参加プロジェクトの未解決スレッド一覧 |
+| POST | `/api/minion/threads` | スレッドを起票（scope, category対応。初回メッセージを同時作成） |
+| GET | `/api/minion/threads/open` | 未解決スレッド一覧（`?scope=all\|project\|workspace`） |
 | 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削除 |
+| DELETE | `/api/minion/threads/:id` | スレッドを完全削除（project: PMのみ、workspace: オーナーの全ミニオン）。メッセージもCASCADE削除 |
 
 ローカルエージェントの `/api/threads` は上記 HQ API へのプロキシ。
-詳細なリクエスト/レスポンス仕様はローカル API セクションの「Project Threads」を参照。
+詳細なリクエスト/レスポンス仕様はローカル API セクションの「Threads」を参照。
 
 ### Project Memories (HQ)
 

package/package.json

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

package/rules/core.md

@@ -174,12 +174,15 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 ### 対処フロー
 
 ```
-1. プロジェクトメモリーを検索（過去に同じ問題が解決済みか確認）
+1. プロジェクトコンテキストの場合:
+   プロジェクトメモリーを検索（過去に同じ問題が解決済みか確認）
    GET /api/project-memories?project_id=...&category=...&search=キーワード
 
 2-a. 該当する知見あり → 知見に基づいて自己解決を試みる
 
 2-b. 該当なし or 自己解決不可 → ヘルプスレッドを起票
+
+   ■ ワークフロー実行中（プロジェクトあり）→ プロジェクトスレッド:
    POST /api/threads
    {
      "project_id": "...",
@@ -193,9 +196,24 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
      }
    }
 
+   ■ ルーティン実行中（プロジェクトなし）→ ワークスペーススレッド:
+   POST /api/threads
+   {
+     "scope": "workspace",
+     "category": "general",
+     "thread_type": "help",
+     "title": "問題の要約（1行）",
+     "content": "状況の詳細説明",
+     "mentions": ["user"],
+     "context": {
+       "category": "auth|environment|external-service|information|approval",
+       "attempted_resolution": "試行した内容"
+     }
+   }
+
 3. スレッドの返信を待つ（thread_watcher が自動監視）
 
-4. 解決後 → プロジェクトメモリーに知見を保存
+4. 解決後 → プロジェクトスレッドの場合はプロジェクトメモリーに知見を保存
    POST /api/project-memories
    {
      "project_id": "...",
@@ -206,6 +224,14 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
    }
 ```
 
+### スレッドスコープの使い分け
+
+| 状況 | スコープ | 説明 |
+|------|---------|------|
+| ワークフロー実行中のブロッカー | `scope: "project"` (デフォルト) | `project_id` 必須。プロジェクトメンバーが参加 |
+| ルーティン実行中のブロッカー | `scope: "workspace"` | `project_id` 不要。オーナーの全ミニオンが参加 |
+| プロジェクト外の一般的な質問・報告 | `scope: "workspace"` | カテゴリ: `general`, `ops`, `standup` |
+
 ### メンションの使い分け
 
 | 状況 | メンション |