@geekbeer/minion 3.9.0 → 3.10.0

package/core/api.js

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

package/core/lib/thread-watcher.js

@@ -2,7 +2,7 @@
  * Project Thread Watcher
  *
  * Polling daemon that monitors open help/discussion threads in the minion's
- * projects. Uses LLM to decide whether to participate in conversations.
+ * workspace. Uses LLM to decide whether to participate in conversations.
  *
  * Token-saving strategies:
  * 1. Read tracking: only evaluate threads with new messages since last check
@@ -68,7 +68,7 @@ async function getMyProjects() {
  *
  * @param {object} thread
  * @param {object[]} messages - Only new messages to check
- * @param {string} myRole - This minion's role in the project
+ * @param {string} myRole - This minion's role in the relevant project (or 'engineer' default)
  * @returns {boolean}
  */
 function isMentioned(thread, messages, myRole) {
@@ -130,14 +130,20 @@ async function pollOnce() {
  * Process a single thread: check for new activity and evaluate if needed.
  */
 async function processThread(thread, myProjects, now) {
-  // 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
+  // Determine role from linked projects (use first matching project)
+  let myRole = 'engineer'
+  let projectContext = null
+  const linkedProjects = thread.linked_projects || []
+
+  if (linkedProjects.length > 0) {
+    for (const lp of linkedProjects) {
+      const myProject = myProjects.find(p => p.id === lp.id)
+      if (myProject) {
+        myRole = myProject.role || 'engineer'
+        projectContext = myProject
+        break
+      }
+    }
   }
 
   const state = readState.get(thread.id) || { lastMessageCount: 0, lastEvalAt: 0 }
@@ -172,7 +178,7 @@ async function processThread(thread, myProjects, now) {
   readState.set(thread.id, { ...state, lastMessageCount: messageCount })
 
   // Check mentions first (no LLM needed to decide relevance)
-  const mentioned = isMentioned(thread, newMessages, myProject.role)
+  const mentioned = isMentioned(thread, newMessages, myRole)
 
   // If not mentioned and cooldown not expired, skip LLM evaluation
   if (!mentioned && now - state.lastEvalAt < EVAL_COOLDOWN_MS) {
@@ -187,14 +193,14 @@ async function processThread(thread, myProjects, now) {
   }
 
   // LLM evaluation
-  await evaluateWithLlm(thread, detail.thread, messages, newMessages, myProject, mentioned)
+  await evaluateWithLlm(thread, detail.thread, messages, newMessages, myRole, projectContext, mentioned)
   readState.set(thread.id, { lastMessageCount: messageCount, lastEvalAt: now })
 }
 
 /**
  * Use LLM to evaluate thread and potentially respond.
  */
-async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMessages, myProject, mentioned) {
+async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMessages, myRole, projectContext, mentioned) {
   // Build conversation context (limit to last 20 messages to control tokens)
   const recentMessages = allMessages.slice(-20)
   const messageHistory = recentMessages
@@ -218,10 +224,21 @@ async function evaluateWithLlm(threadSummary, threadDetail, allMessages, newMess
     ctx.attempted_resolution ? `試行済み: ${ctx.attempted_resolution}` : '',
   ].filter(Boolean).join('\n')
 
-  const isWorkspace = threadDetail.scope === 'workspace'
-  const scopeContext = isWorkspace
-    ? `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこれはプロジェクトに属さないワークスペーススレッドです（カテゴリ: ${threadDetail.category || 'general'}）。`
-    : `あなたはプロジェクト「${myProject.name}」のチームメンバー（ロール: ${myProject.role}、ID: ${config.MINION_ID}）です。`
+  // Build scope context from linked projects
+  const linkedProjects = threadDetail.linked_projects || []
+  let scopeContext
+  if (projectContext) {
+    scopeContext = `あなたはプロジェクト「${projectContext.name}」のチームメンバー（ロール: ${myRole}、ID: ${config.MINION_ID}）です。`
+  } else if (linkedProjects.length > 0) {
+    const projectNames = linkedProjects.map(p => p.name).join(', ')
+    scopeContext = `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこのスレッドは以下のプロジェクトに紐づいています: ${projectNames}`
+  } else {
+    scopeContext = `あなたはワークスペースのメンバー（ID: ${config.MINION_ID}）です。\nこれはプロジェクトに紐づかないワークスペーススレッドです（カテゴリ: ${threadDetail.category || 'general'}）。`
+  }
+
+  const roleGuidance = projectContext
+    ? `- 自分のロール（${myRole}）に関連する話題か`
+    : '- ワークスペーススレッドではすべてのミニオンが参加可能。自分が貢献できる場合は積極的に参加する'
 
   const prompt = `${scopeContext}
 以下のスレッドに対して、あなたが返信すべきかどうかを判断し、返信する場合はその内容を生成してください。
@@ -247,7 +264,7 @@ ${messageHistory || '(メッセージなし)'}
 判断基準:
 - 自分が起票したスレッドの場合、他のメンバーの回答を待つべき（追加情報がある場合を除く）
 - メンション対象が特定のロールやミニオンに限定されている場合、自分が対象でなければ静観する
-${isWorkspace ? '- ワークスペーススレッドではすべてのミニオンが参加可能。自分が貢献できる場合は積極的に参加する' : `- 自分のロール（${myProject.role}）に関連する話題か`}
+${roleGuidance}
 - 自分が貢献できる知見や意見があるか
 - 既に十分な回答がある場合は重複を避ける
 - 人間に聞くべき場合は @user メンションを含めて返信する
@@ -289,13 +306,17 @@ ${isWorkspace ? '- ワークスペーススレッドではすべてのミニオ
     if (parsed.todo && parsed.todo.title) {
       try {
         const todoStore = require('../stores/todo-store')
+        // Use first linked project ID if available
+        const linkedProjectId = (threadSummary.linked_projects && threadSummary.linked_projects.length > 0)
+          ? threadSummary.linked_projects[0].id
+          : null
         todoStore.add({
           title: parsed.todo.title,
           priority: parsed.todo.priority || 'normal',
           due_at: parsed.todo.due_at || null,
           source_type: 'thread',
           source_id: threadSummary.id,
-          project_id: threadSummary.project_id || null,
+          project_id: linkedProjectId,
         })
         console.log(`[ThreadWatcher] Created TODO from thread: "${parsed.todo.title}"`)
       } catch (err) {
@@ -309,17 +330,20 @@ ${isWorkspace ? '- ワークスペーススレッドではすべてのミニオ
 
 /**
  * Fallback: memory-only matching when LLM is not available.
+ * Uses linked projects to search for relevant memories.
  */
 async function fallbackMemoryMatch(thread) {
   try {
-    // Workspace threads have no project_id — skip memory matching
-    if (!thread.project_id) return
+    const linkedProjects = thread.linked_projects || []
+    if (linkedProjects.length === 0) return
 
+    // Search memories from the first linked project
+    const projectId = linkedProjects[0].id
     const ctx = thread.context || {}
     const category = ctx.category || ''
     const searchParam = category ? `&category=${category}` : ''
     const memData = await api.request(
-      `/project-memories?project_id=${thread.project_id}${searchParam}`
+      `/project-memories?project_id=${projectId}${searchParam}`
     )
 
     if (!memData.memories || memData.memories.length === 0) return

package/docs/api-reference.md

@@ -287,27 +287,26 @@ GET `/api/daemons/status` response:
 
 ### Threads (スレッド)
 
-プロジェクト内またはワークスペースレベルのコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
+ワークスペースレベルのコミュニケーションチャネル。ブロッカー共有やチーム議論に使う。
 リクエストは HQ にプロキシされる。
 
-**2つのスコープ:**
-- **Project** (`scope: "project"`): プロジェクトに紐づくスレッド。`project_id` 必須。プロジェクトメンバーが参加。
-- **Workspace** (`scope: "workspace"`): プロジェクトに属さないスレッド。ルーティンのブロッカー、全体連絡等。オーナーの全ミニオンが参加。
+すべてのスレッドはワークスペースに所属し、プロジェクトへの紐づけは多対多（`thread_project_links`）で管理される。
+1つのスレッドを複数プロジェクトにリンクしたり、プロジェクトに紐づけずにワークスペース全体のスレッドとして使うこともできる。
 
 | 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` | スレッドを完全削除（project: PMのみ、workspace: オーナーの全ミニオン） |
+| DELETE | `/api/threads/:id` | スレッドを完全削除 |
 
-POST `/api/threads` body (プロジェクトスレッド — ヘルプ):
+POST `/api/threads` body (プロジェクト紐づきヘルプスレッド):
 ```json
 {
-  "project_id": "uuid",
+  "project_ids": ["uuid"],
   "thread_type": "help",
   "title": "ランサーズの2FA認証コードが必要",
   "content": "ログイン時に2段階認証を要求された。メールで届く6桁コードの入力が必要。",
@@ -322,7 +321,6 @@ POST `/api/threads` body (プロジェクトスレッド — ヘルプ):
 POST `/api/threads` body (ワークスペーススレッド — ルーティンのブロッカー):
 ```json
 {
-  "scope": "workspace",
   "category": "general",
   "thread_type": "help",
   "title": "朝作業ルーティン: APIキーの期限切れ",
@@ -335,10 +333,10 @@ POST `/api/threads` body (ワークスペーススレッド — ルーティン
 }
 ```
 
-POST `/api/threads` body (プロジェクトスレッド — ディスカッション):
+POST `/api/threads` body (プロジェクト紐づきディスカッション):
 ```json
 {
-  "project_id": "uuid",
+  "project_ids": ["uuid"],
   "thread_type": "discussion",
   "title": "デプロイ手順の確認",
   "content": "本番デプロイ前にステージングで確認するフローに変えたい。意見ある？",
@@ -348,19 +346,19 @@ POST `/api/threads` body (プロジェクトスレッド — ディスカッシ
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `scope` | string | No | `project`（デフォルト）or `workspace` |
-| `project_id` | string | scope=project時 Yes | プロジェクト UUID |
-| `category` | string | No | ワークスペーススレッドのカテゴリ: `general`（デフォルト）, `ops`, `standup` |
+| `project_id` | string | No | リンクするプロジェクトUUID（単一、後方互換） |
+| `project_ids` | string[] | No | リンクするプロジェクト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`
+**プロジェクト紐づけの使い分け:**
+- ワークフロー実行中（プロジェクトあり）→ `project_ids: ["uuid"]`
+- ルーティン実行中（プロジェクトなし）→ `project_ids` を省略
+- プロジェクト外の一般的な質問・報告 → `project_ids` を省略 + `category`
 
 **thread_type の違い:**
 - `help`: ブロッカー解決。`resolve` で解決
@@ -447,8 +445,8 @@ POST `/api/project-memories` body:
 **推奨ワークフロー:**
 1. ブロッカー発生 → プロジェクトコンテキストの場合は `GET /api/project-memories?project_id=...&category=auth&search=2fa` で既知の知見を検索
 2. 該当あり → 知見に基づいて自己解決 or 即エスカレーション
-3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトなら `scope: "project"` + `project_id`、ルーティンなら `scope: "workspace"`）
-4. 解決後 → プロジェクトスレッドの場合は `POST /api/project-memories` で知見を蓄積
+3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトありなら `project_ids: ["uuid"]`、なしなら省略）
+4. 解決後 → プロジェクト紐づきスレッドの場合は `POST /api/project-memories` で知見を蓄積
 
 ### Email
 
@@ -909,8 +907,8 @@ Response:
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| POST | `/api/minion/threads` | スレッドを起票（scope, category対応。初回メッセージを同時作成） |
-| GET | `/api/minion/threads/open` | 未解決スレッド一覧（`?scope=all\|project\|workspace`） |
+| POST | `/api/minion/threads` | スレッドを起票（project_ids, category対応。初回メッセージを同時作成） |
+| GET | `/api/minion/threads/open` | 未解決スレッド一覧（`?project_id=uuid` で絞り込み可） |
 | GET | `/api/minion/threads/:id` | スレッド詳細 + メッセージ一覧 |
 | POST | `/api/minion/threads/:id/messages` | スレッドにメッセージを投稿 |
 | PATCH | `/api/minion/threads/:id/resolve` | スレッドを解決済みにする。Body: `{resolution}` |

package/package.json

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

package/rules/core.md

@@ -198,10 +198,10 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 
 2-b. 該当なし or 自己解決不可 → ヘルプスレッドを起票
 
-   ■ ワークフロー実行中（プロジェクトあり）→ プロジェクトスレッド:
+   ■ ワークフロー実行中（プロジェクトあり）→ プロジェクト紐づきスレッド:
    POST /api/threads
    {
-     "project_id": "...",
+     "project_ids": ["..."],
      "thread_type": "help",
      "title": "問題の要約（1行）",
      "content": "状況の詳細説明",
@@ -215,7 +215,6 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
    ■ ルーティン実行中（プロジェクトなし）→ ワークスペーススレッド:
    POST /api/threads
    {
-     "scope": "workspace",
      "category": "general",
      "thread_type": "help",
      "title": "問題の要約（1行）",
@@ -229,7 +228,7 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
 
 3. スレッドの返信を待つ（thread_watcher が自動監視）
 
-4. 解決後 → プロジェクトスレッドの場合はプロジェクトメモリーに知見を保存
+4. 解決後 → プロジェクト紐づきスレッドの場合はプロジェクトメモリーに知見を保存
    POST /api/project-memories
    {
      "project_id": "...",
@@ -240,13 +239,13 @@ Routine 実行中は以下もtmuxセッション環境で利用可能:
    }
 ```
 
-### スレッドスコープの使い分け
+### スレッドのプロジェクト紐づけ
 
-| 状況 | スコープ | 説明 |
-|------|---------|------|
-| ワークフロー実行中のブロッカー | `scope: "project"` (デフォルト) | `project_id` 必須。プロジェクトメンバーが参加 |
-| ルーティン実行中のブロッカー | `scope: "workspace"` | `project_id` 不要。オーナーの全ミニオンが参加 |
-| プロジェクト外の一般的な質問・報告 | `scope: "workspace"` | カテゴリ: `general`, `ops`, `standup` |
+| 状況 | 設定 | 説明 |
+|------|------|------|
+| ワークフロー実行中のブロッカー | `project_ids: ["uuid"]` | プロジェクトに紐づけ。プロジェクトビューに表示される |
+| ルーティン実行中のブロッカー | `project_ids` を省略 | プロジェクトに紐づけない。ワークスペース全体に表示 |
+| プロジェクト外の一般的な質問・報告 | `project_ids` を省略 + `category` | カテゴリ: `general`, `ops`, `standup` |
 
 ### メンションの使い分け