@geekbeer/minion 3.8.1 → 3.9.0

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
 }
 ```
 

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.1",
+  "version": "3.9.0",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

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`,
       '',