@geekbeer/minion 3.8.0 → 3.9.0

package/core/config.js

@@ -75,6 +75,7 @@ const config = {
   HQ_URL: process.env.HQ_URL || '',
   API_TOKEN: process.env.API_TOKEN || '',
   MINION_ID: process.env.MINION_ID || '',
+  MINION_EMAIL: process.env.MINION_ID ? `m-${process.env.MINION_ID}@minion-agent.com` : '',
 
   // Server settings
   AGENT_PORT: parseInt(process.env.AGENT_PORT, 10) || 8080,
@@ -111,6 +112,12 @@ function validate() {
   } else {
     console.log('[Config] HQ not configured, running in standalone mode')
   }
+
+  // Expose MINION_EMAIL to child processes (e.g. Claude Code, Gemini CLI)
+  if (config.MINION_EMAIL) {
+    process.env.MINION_EMAIL = config.MINION_EMAIL
+    console.log(`[Config] Email: ${config.MINION_EMAIL}`)
+  }
 }
 
 /**

package/core/db.js

@@ -425,6 +425,23 @@ function migrateSchema(db) {
 
     console.log('[DB] Migration 2 complete: emails FTS5 added')
   }
+
+  if (currentVersion < 3) {
+    console.log('[DB] Migration 3: Adding project_id to memories...')
+
+    db.exec(`
+      -- Add nullable project_id column to memories table.
+      -- NULL = universal memory (cross-project knowledge).
+      -- Set = project-scoped memory.
+      ALTER TABLE memories ADD COLUMN project_id TEXT DEFAULT NULL;
+
+      CREATE INDEX idx_memories_project_id ON memories(project_id);
+
+      INSERT INTO schema_version (version) VALUES (3);
+    `)
+
+    console.log('[DB] Migration 3 complete: memories.project_id added')
+  }
 }
 
 /**

package/core/lib/end-of-day.js

@@ -42,8 +42,10 @@ async function runEndOfDay({ runQuickLlmCall, clearSession = false }) {
    - title: 短いタイトル
    - category: user（ユーザーの好み）/ feedback（フィードバック）/ project（プロジェクト情報）/ reference（参照情報）のいずれか
    - content: 詳細な内容
+   - project_id: この学びが特定プロジェクトに固有の場合はそのプロジェクトID（UUID）。汎用的なノウハウやユーザーの好みなど、プロジェクト横断で活用すべき学びの場合はnull
 
 学びがない場合は空配列にしてください。すでに常識的なことは含めないでください。
+特定のプロジェクトの技術スタック・ルール・設計判断などはproject_idを設定し、汎用的なスキルや知見はnullにしてください。
 
 会話:
 ${conversationText}
@@ -83,6 +85,7 @@ JSON形式のみで回答してください（\`\`\`jsonブロックは不要）
             title: learning.title,
             category: learning.category || 'reference',
             content: learning.content,
+            project_id: learning.project_id || null,
           })
           memoriesAdded++
         }

package/core/routes/memory.js

@@ -4,11 +4,17 @@
  * Provides CRUD + search for the minion's long-term memory entries.
  * Memory is stored in SQLite with FTS5 full-text search.
  *
+ * project_id scoping:
+ *   - Entries with project_id are scoped to a specific project.
+ *   - Entries without project_id are universal (cross-project knowledge).
+ *   - Queries with ?project_id=xxx return scoped + universal entries.
+ *
  * Endpoints:
  *   GET    /api/memory          - List all entries (or search with ?search=keyword)
+ *                                 Optional: ?project_id=xxx to scope results
  *   GET    /api/memory/:id      - Get a single entry
- *   POST   /api/memory          - Create a new entry
- *   PUT    /api/memory/:id      - Update an entry
+ *   POST   /api/memory          - Create a new entry (optional project_id in body)
+ *   PUT    /api/memory/:id      - Update an entry (optional project_id in body)
  *   DELETE /api/memory/:id      - Delete an entry
  */
 
@@ -28,13 +34,13 @@ async function memoryRoutes(fastify) {
       return { success: false, error: 'Unauthorized' }
     }
 
-    const { search } = request.query || {}
+    const { search, project_id } = request.query || {}
     if (search) {
-      const entries = memoryStore.searchEntries(search)
+      const entries = memoryStore.searchEntries(search, { projectId: project_id })
       return { success: true, entries }
     }
 
-    const entries = memoryStore.listEntries()
+    const entries = memoryStore.listEntries({ projectId: project_id })
     return { success: true, entries }
   })
 
@@ -61,14 +67,14 @@ async function memoryRoutes(fastify) {
       return { success: false, error: 'Unauthorized' }
     }
 
-    const { title, category, content } = request.body || {}
+    const { title, category, content, project_id } = request.body || {}
     if (!title || !content) {
       reply.code(400)
       return { success: false, error: 'title and content are required' }
     }
 
-    const entry = memoryStore.saveEntry({ title, category, content })
-    console.log(`[Memory] Created entry: ${entry.id} (${entry.title})`)
+    const entry = memoryStore.saveEntry({ title, category, content, project_id })
+    console.log(`[Memory] Created entry: ${entry.id} (${entry.title})${entry.project_id ? ` [project:${entry.project_id}]` : ' [universal]'}`)
     return { success: true, entry }
   })
 
@@ -85,15 +91,16 @@ async function memoryRoutes(fastify) {
       return { success: false, error: 'Entry not found' }
     }
 
-    const { title, category, content } = request.body || {}
+    const { title, category, content, project_id } = request.body || {}
     const entry = memoryStore.saveEntry({
       id: request.params.id,
       title: title || existing.title,
       category: category || existing.category,
       content: content !== undefined ? content : existing.content,
+      project_id: project_id !== undefined ? project_id : existing.project_id,
     })
 
-    console.log(`[Memory] Updated entry: ${entry.id} (${entry.title})`)
+    console.log(`[Memory] Updated entry: ${entry.id} (${entry.title})${entry.project_id ? ` [project:${entry.project_id}]` : ' [universal]'}`)
     return { success: true, entry }
   })
 

package/core/stores/memory-store.js

@@ -4,6 +4,11 @@
  * Supports full-text search via FTS5.
  *
  * Categories: user, feedback, project, reference
+ *
+ * project_id scoping:
+ *   - NULL project_id = universal memory (cross-project knowledge/know-how)
+ *   - Set project_id  = project-scoped memory
+ *   - When querying with a project_id, returns both scoped + universal entries
  */
 
 const crypto = require('crypto')
@@ -13,17 +18,31 @@ const VALID_CATEGORIES = ['user', 'feedback', 'project', 'reference']
 
 /**
  * List all memory entries (metadata + excerpt, no full body).
- * @returns {Array<{ id, title, category, created_at, updated_at, excerpt }>}
+ * @param {{ projectId?: string }} [opts] - Optional filter options
+ *   - projectId: If set, returns entries for that project + universal (NULL) entries.
+ *                If omitted, returns all entries.
+ * @returns {Array<{ id, title, category, project_id, created_at, updated_at, excerpt }>}
  */
-function listEntries() {
+function listEntries(opts = {}) {
   const db = getDb()
-  const rows = db.prepare(`
-    SELECT id, title, category, created_at, updated_at,
+  const { projectId } = opts
+
+  if (projectId) {
+    return db.prepare(`
+      SELECT id, title, category, project_id, created_at, updated_at,
+             substr(content, 1, 200) as excerpt
+      FROM memories
+      WHERE project_id = ? OR project_id IS NULL
+      ORDER BY updated_at DESC
+    `).all(projectId)
+  }
+
+  return db.prepare(`
+    SELECT id, title, category, project_id, created_at, updated_at,
            substr(content, 1, 200) as excerpt
     FROM memories
     ORDER BY updated_at DESC
   `).all()
-  return rows
 }
 
 /**
@@ -39,7 +58,8 @@ function loadEntry(id) {
 
 /**
  * Save (create or update) a memory entry.
- * @param {{ id?, title, category, content }} entry
+ * @param {{ id?, title, category, content, project_id? }} entry
+ *   - project_id: UUID of the project this memory belongs to, or null/undefined for universal
  * @returns {object} The saved entry
  */
 function saveEntry(entry) {
@@ -47,6 +67,7 @@ function saveEntry(entry) {
   const now = new Date().toISOString()
   const id = entry.id || crypto.randomBytes(6).toString('hex')
   const category = VALID_CATEGORIES.includes(entry.category) ? entry.category : 'reference'
+  const projectId = entry.project_id || null
 
   const existing = db.prepare('SELECT created_at FROM memories WHERE id = ?').get(id)
 
@@ -55,20 +76,21 @@ function saveEntry(entry) {
     title: entry.title || 'Untitled',
     category,
     content: entry.content || '',
+    project_id: projectId,
     created_at: existing ? existing.created_at : now,
     updated_at: now,
   }
 
   if (existing) {
     db.prepare(`
-      UPDATE memories SET title = ?, category = ?, content = ?, updated_at = ?
+      UPDATE memories SET title = ?, category = ?, content = ?, project_id = ?, updated_at = ?
       WHERE id = ?
-    `).run(full.title, full.category, full.content, full.updated_at, full.id)
+    `).run(full.title, full.category, full.content, full.project_id, full.updated_at, full.id)
   } else {
     db.prepare(`
-      INSERT INTO memories (id, title, category, content, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?)
-    `).run(full.id, full.title, full.category, full.content, full.created_at, full.updated_at)
+      INSERT INTO memories (id, title, category, content, project_id, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(full.id, full.title, full.category, full.content, full.project_id, full.created_at, full.updated_at)
   }
 
   return full
@@ -89,11 +111,14 @@ function deleteEntry(id) {
  * Search memory entries using FTS5 full-text search (trigram tokenizer).
  * Falls back to LIKE for queries shorter than 3 characters (trigram minimum).
  * @param {string} query - Search query
- * @param {number} limit - Max results
- * @returns {Array<{ id, title, category, content, created_at, updated_at }>}
+ * @param {{ limit?: number, projectId?: string }} [opts] - Search options
+ *   - limit: Max results (default 20)
+ *   - projectId: If set, returns matches for that project + universal (NULL) entries
+ * @returns {Array<{ id, title, category, project_id, content, created_at, updated_at }>}
  */
-function searchEntries(query, limit = 20) {
+function searchEntries(query, opts = {}) {
   const db = getDb()
+  const { limit = 20, projectId } = typeof opts === 'number' ? { limit: opts } : opts
   const terms = query.split(/\s+/).filter(Boolean)
   if (terms.length === 0) return []
 
@@ -108,11 +133,18 @@ function searchEntries(query, limit = 20) {
       const like = `%${t}%`
       return [like, like]
     })
+
+    let projectFilter = ''
+    if (projectId) {
+      projectFilter = ' AND (project_id = ? OR project_id IS NULL)'
+      params.push(projectId)
+    }
+
     params.push(limit)
     return db.prepare(`
-      SELECT id, title, category, content, created_at, updated_at
+      SELECT id, title, category, project_id, content, created_at, updated_at
       FROM memories
-      WHERE ${conditions}
+      WHERE ${conditions}${projectFilter}
       ORDER BY updated_at DESC
       LIMIT ?
     `).all(...params)
@@ -120,8 +152,21 @@ function searchEntries(query, limit = 20) {
 
   // FTS5 trigram search: wrap each term in double quotes for exact substring match
   const sanitized = terms.map(t => `"${t.replace(/"/g, '')}"`).join(' ')
+
+  if (projectId) {
+    return db.prepare(`
+      SELECT m.id, m.title, m.category, m.project_id, m.content, m.created_at, m.updated_at
+      FROM memories m
+      JOIN memories_fts f ON m.rowid = f.rowid
+      WHERE memories_fts MATCH ?
+        AND (m.project_id = ? OR m.project_id IS NULL)
+      ORDER BY rank
+      LIMIT ?
+    `).all(sanitized, projectId, limit)
+  }
+
   return db.prepare(`
-    SELECT m.id, m.title, m.category, m.content, m.created_at, m.updated_at
+    SELECT m.id, m.title, m.category, m.project_id, m.content, m.created_at, m.updated_at
     FROM memories m
     JOIN memories_fts f ON m.rowid = f.rowid
     WHERE memories_fts MATCH ?
@@ -133,18 +178,22 @@ function searchEntries(query, limit = 20) {
 /**
  * Get a context snippet suitable for chat injection.
  * Returns the most important memory entries as a formatted string.
- * @param {number} maxChars - Maximum characters to return
+ * @param {{ maxChars?: number, projectId?: string }} [opts] - Options
+ *   - maxChars: Maximum characters to return (default 2000)
+ *   - projectId: If set, includes project-scoped + universal entries
  * @returns {string}
  */
-function getContextSnippet(maxChars = 2000) {
-  const entries = listEntries()
+function getContextSnippet(opts = {}) {
+  const { maxChars = 2000, projectId } = typeof opts === 'number' ? { maxChars: opts } : opts
+  const entries = listEntries({ projectId })
   if (entries.length === 0) return ''
 
   const parts = []
   let totalLen = 0
 
   for (const e of entries) {
-    const line = `[${e.category}] ${e.title}: ${e.excerpt}`
+    const scope = e.project_id ? '[project-scoped]' : '[universal]'
+    const line = `${scope} [${e.category}] ${e.title}: ${e.excerpt}`
     if (totalLen + line.length > maxChars) break
     parts.push(line)
     totalLen += line.length + 1

package/docs/api-reference.md

@@ -83,19 +83,26 @@ Full-text search supported via FTS5.
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/memory` | List all memory entries (id, title, category, excerpt, timestamps) |
+| GET | `/api/memory` | List all memory entries (id, title, category, project_id, excerpt, timestamps) |
 | GET | `/api/memory?search=keyword` | Full-text search on title and content (FTS5) |
+| GET | `/api/memory?project_id=xxx` | List entries scoped to project + universal entries |
+| GET | `/api/memory?search=keyword&project_id=xxx` | Search within project scope + universal |
 | GET | `/api/memory/:id` | Get full memory entry |
-| POST | `/api/memory` | Create memory entry. Body: `{title, category, content}` |
-| PUT | `/api/memory/:id` | Update memory entry. Body: `{title?, category?, content?}` |
+| POST | `/api/memory` | Create memory entry. Body: `{title, category, content, project_id?}` |
+| PUT | `/api/memory/:id` | Update memory entry. Body: `{title?, category?, content?, project_id?}` |
 | DELETE | `/api/memory/:id` | Delete a memory entry |
 
+**Project scoping**: `project_id` is optional. When set, the entry is scoped to that project.
+When `project_id` is omitted (NULL), the entry is universal (cross-project knowledge).
+Queries with `?project_id=xxx` return both project-scoped AND universal entries.
+
 POST/PUT body:
 ```json
 {
   "title": "ユーザーはレビューで日本語を好む",
   "category": "user",
-  "content": "コードレビューのコメントは日本語で記述すること。"
+  "content": "コードレビューのコメントは日本語で記述すること。",
+  "project_id": null
 }
 ```
 
@@ -443,6 +450,94 @@ POST `/api/project-memories` body:
 3. 該当なし → `POST /api/threads` でブロッカー起票（プロジェクトなら `scope: "project"` + `project_id`、ルーティンなら `scope: "workspace"`）
 4. 解決後 → プロジェクトスレッドの場合は `POST /api/project-memories` で知見を蓄積
 
+### Email
+
+ミニオン専用メールアドレス (`m-{MINION_ID}@minion-agent.com`) 宛のメールを管理する。
+メールは Cloudflare Email Worker → HQ → ミニオンの経路で自動受信・保存される。
+添付ファイルはセキュリティ上、人間が HQ ダッシュボードで承認するまでデータを取得できない。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/email/inbox/summary` | 未読・合計件数 (`{unread, total, latest_at}`) |
+| GET | `/api/email/inbox` | メール一覧（フィルター対応） |
+| GET | `/api/email/inbox/:id` | メール詳細（添付メタデータ含む） |
+| PUT | `/api/email/inbox/:id` | 既読/未読を更新 |
+| DELETE | `/api/email/inbox/:id` | メールを削除 |
+| POST | `/api/email/inbox/:id/attachments/:attachmentId/approve` | 添付ファイルを承認（HQダッシュボード用） |
+| GET | `/api/email/inbox/:id/attachments/:attachmentId` | 添付ファイルを取得（承認済みのみ） |
+
+GET `/api/email/inbox` query parameters:
+
+| Param | Description |
+|-------|-------------|
+| `is_read` | `0` (未読) or `1` (既読) でフィルター |
+| `from_address` | 送信元アドレスで部分一致検索 |
+| `search` | 件名・本文でテキスト検索（3文字以上でFTS5使用） |
+| `limit` | 取得件数（デフォルト: 50） |
+
+GET `/api/email/inbox/summary` response:
+```json
+{
+  "success": true,
+  "summary": { "unread": 3, "total": 12, "latest_at": "2026-04-01T10:30:00Z" }
+}
+```
+
+GET `/api/email/inbox` response:
+```json
+{
+  "success": true,
+  "emails": [
+    {
+      "id": "abc123",
+      "from_address": "user@example.com",
+      "to_address": "m-uuid@minion-agent.com",
+      "subject": "タスクの依頼",
+      "body_text": "...",
+      "body_html": "...",
+      "received_at": "2026-04-01T10:30:00Z",
+      "is_read": 0,
+      "labels": []
+    }
+  ]
+}
+```
+
+GET `/api/email/inbox/:id` response (添付ファイル付き):
+```json
+{
+  "success": true,
+  "email": {
+    "id": "abc123",
+    "from_address": "user@example.com",
+    "to_address": "m-uuid@minion-agent.com",
+    "subject": "資料送付",
+    "body_text": "...",
+    "body_html": "...",
+    "received_at": "2026-04-01T10:30:00Z",
+    "is_read": 0,
+    "labels": [],
+    "attachments": [
+      {
+        "id": "att456",
+        "email_id": "abc123",
+        "filename": "report.pdf",
+        "content_type": "application/pdf",
+        "size_bytes": 102400,
+        "approved": 0
+      }
+    ]
+  }
+}
+```
+
+PUT `/api/email/inbox/:id` body:
+```json
+{ "is_read": 1 }
+```
+
+Note: 既読メールは受信後90日で自動削除される。未読メールは保持される。
+
 ### Commands
 
 | Method | Endpoint | Description |

package/linux/routes/chat.js

@@ -246,6 +246,9 @@ async function buildContextPrefix(message, context, sessionId) {
       '# メモリ検索（キーワードで全文検索）',
       `curl -H "Authorization: Bearer $API_TOKEN" "${baseUrl}/api/memory?search=キーワード"`,
       '',
+      '# プロジェクトスコープでメモリ検索（プロジェクト固有 + 汎用メモリを返す）',
+      `curl -H "Authorization: Bearer $API_TOKEN" "${baseUrl}/api/memory?search=キーワード&project_id=プロジェクトUUID"`,
+      '',
       '# メモリ一覧',
       `curl -H "Authorization: Bearer $API_TOKEN" ${baseUrl}/api/memory`,
       '',

package/package.json

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

package/rules/core.md

@@ -27,6 +27,19 @@ Minion
 - **Routine**: ミニオンスコープ。ミニオンローカルの定期タスク。
 - ミニオンは複数プロジェクトに `pm` または `engineer` として参加できる。
 
+## Email
+
+各ミニオンには専用メールアドレス `m-{MINION_ID}@minion-agent.com` が割り当てられている。
+受信メールはローカルSQLiteに自動保存され、Agent APIで確認できる。
+
+- **受信確認**: `GET /api/email/inbox/summary` で未読件数を確認
+- **メール一覧**: `GET /api/email/inbox` でメール一覧を取得（フィルター・検索対応）
+- **メール詳細**: `GET /api/email/inbox/:id` で本文・添付ファイルを確認
+- **既読管理**: `PUT /api/email/inbox/:id` で既読/未読を切り替え
+- **添付ファイル**: 添付ファイルはセキュリティ上、人間がHQダッシュボードで承認するまでダウンロード不可
+
+API の詳細仕様は `~/.minion/docs/api-reference.md` の「Email」セクションを参照。
+
 ## Available Tools
 
 ### CLI
@@ -127,6 +140,7 @@ Note: Codex CLI の `.codex/` ディレクトリはLLMからの直接編集が
 | `MINION_ID` | UUID assigned by HQ |
 | `AGENT_PORT` | Agent HTTP port (default: 8080) |
 | `MINION_USER` | System user running the agent |
+| `MINION_EMAIL` | Minion email address (`m-{MINION_ID}@minion-agent.com`) |
 
 Routine 実行中は以下もtmuxセッション環境で利用可能:
 - `MINION_EXECUTION_ID` — 実行UUID

package/settings/permissions.json

@@ -6,7 +6,8 @@
     "Edit",
     "WebSearch",
     "WebFetch",
-    "mcp__playwright__*"
+    "mcp__playwright__*",
+    "mcp__desktop-commander__*"
   ],
   "deny": [
     "Bash(sudo *)",

package/win/routes/chat.js

@@ -208,6 +208,9 @@ async function buildContextPrefix(message, context, sessionId) {
       '# メモリ検索（キーワードで全文検索）',
       `curl -H "Authorization: Bearer $API_TOKEN" "${baseUrl}/api/memory?search=キーワード"`,
       '',
+      '# プロジェクトスコープでメモリ検索（プロジェクト固有 + 汎用メモリを返す）',
+      `curl -H "Authorization: Bearer $API_TOKEN" "${baseUrl}/api/memory?search=キーワード&project_id=プロジェクトUUID"`,
+      '',
       '# メモリ一覧',
       `curl -H "Authorization: Bearer $API_TOKEN" ${baseUrl}/api/memory`,
       '',