memory-journal-mcp 4.4.2 → 5.0.0

package/SECURITY.md

@@ -4,29 +4,19 @@ The Memory Journal MCP server implements comprehensive security measures to prot
 
 ## 🛡️ **Database Security**
 
-### **WAL Mode Enabled**
-
-- ✅ **Write-Ahead Logging (WAL)** enabled for better concurrency and crash recovery
-- ✅ **Atomic transactions** ensure data consistency
-- ✅ **Better performance** with concurrent read/write operations
-
-### **Optimized PRAGMA Settings**
-
-```sql
-PRAGMA foreign_keys = ON          -- Enforce referential integrity
-PRAGMA journal_mode = WAL         -- Enable WAL mode
-PRAGMA synchronous = NORMAL       -- Balance safety and performance
-PRAGMA cache_size = -64000        -- 64MB cache for better performance
-PRAGMA mmap_size = 268435456      -- 256MB memory-mapped I/O
-PRAGMA temp_store = MEMORY        -- Store temp tables in memory
-PRAGMA busy_timeout = 30000       -- 30-second timeout for busy database
-```
+### **sql.js In-Memory Architecture**
+
+The server uses **sql.js** (pure JavaScript SQLite compiled to WebAssembly) which operates on an in-memory database copy with periodic flushing to disk. This differs from native SQLite:
 
-### **File Permissions**
+- ✅ **PRAGMA foreign_keys = ON** — enforces referential integrity and `ON DELETE CASCADE`
+- ✅ **Parameterized queries** — all user input bound via `?` placeholders
+- ✅ **Debounced disk writes** — periodic flushing with immediate flush on critical operations
+- ⚠️ WAL mode, mmap, busy_timeout, and other file-level PRAGMAs are **not applicable** to sql.js
 
-- ✅ **Database files**: `600` (read/write for owner only)
-- ✅ **Data directory**: `700` (full access for owner only)
-- ✅ **Automatic permission setting** on database creation
+### **File Permissions (Docker)**
+
+- ✅ **Data directory**: `700` (full access for owner only) in Docker
+- ✅ **Non-root user** (`appuser:appgroup`) owns data directory
 
 ## 🔐 **Input Validation**
 
@@ -38,11 +28,10 @@ PRAGMA busy_timeout = 30000       -- 30-second timeout for busy database
 - **Significance types**: 50 characters maximum
 - **HTTP request body**: 1MB maximum (prevents memory exhaustion)
 
-### **Character Filtering**
-
-Dangerous characters are blocked in tags:
+### **Character Handling**
 
-- `<` `>` `"` `'` `&` `\x00`
+Tags are stored as-is via parameterized queries. Special characters in tags
+are safely handled by the database layer and do not pose injection risks.
 
 ### **SQL Injection Prevention**
 
@@ -77,8 +66,12 @@ export MCP_CORS_ORIGIN="http://localhost:3000"
 
 ### **Security Headers**
 
-- ✅ **X-Content-Type-Options: nosniff** - prevents MIME sniffing
-- ✅ **X-Frame-Options: DENY** - prevents clickjacking
+- ✅ **X-Content-Type-Options: nosniff** — prevents MIME sniffing
+- ✅ **X-Frame-Options: DENY** — prevents clickjacking
+- ✅ **Content-Security-Policy: default-src 'none'; frame-ancestors 'none'** — prevents XSS and framing
+- ✅ **Cache-Control: no-store** — prevents caching of sensitive journal data
+- ✅ **Referrer-Policy: no-referrer** — prevents referrer leakage
+- ⚠️ **CORS wildcard warning** — server logs a warning when CORS origin is `*`
 
 ### **Session Management (Stateful Mode)**
 
@@ -187,17 +180,16 @@ docker run --memory=1g --cpus=1 memory-journal-mcp
 
 ## 📋 **Security Checklist**
 
-- [x] WAL mode enabled for database consistency
-- [x] Proper file permissions (600/700)
+- [x] Foreign key enforcement (`PRAGMA foreign_keys = ON`)
 - [x] Input validation and length limits (Zod schemas)
 - [x] Parameterized SQL queries
-- [x] SQL injection detection heuristics
-- [x] Path traversal protection
-- [x] LIKE pattern sanitization
-- [x] Date format whitelisting
+- [x] SQL injection detection heuristics (defense-in-depth)
+- [x] Path traversal protection (`assertNoPathTraversal`)
+- [x] LIKE pattern sanitization (`sanitizeSearchQuery`)
+- [x] Date format whitelisting (`validateDateFormatPattern`)
 - [x] HTTP body size limit (1MB)
-- [x] Configurable CORS origin
-- [x] Security headers (X-Content-Type-Options, X-Frame-Options)
+- [x] Configurable CORS origin (with wildcard warning)
+- [x] Security headers (CSP, X-Content-Type-Options, X-Frame-Options, Cache-Control, Referrer-Policy)
 - [x] Session timeout (30 minutes)
 - [x] Non-root Docker user
 - [x] Multi-stage Docker build

package/dist/cli.js

@@ -14,12 +14,18 @@ program
     .option('--port <number>', 'HTTP port (for http transport)', '3000')
     .option('--server-host <host>', 'Server bind host for HTTP transport (default: localhost)')
     .option('--stateless', 'Use stateless HTTP mode (no session management)')
-    .option('--db <path>', 'Database path', './memory_journal.db')
+    .option('--db <path>', 'Database path (env: DB_PATH)', process.env['DB_PATH'] ?? './memory_journal.db')
+    .option('--team-db <path>', 'Team database path (env: TEAM_DB_PATH)', process.env['TEAM_DB_PATH'] ?? undefined)
     .option('--tool-filter <filter>', 'Tool filter string (e.g., "starter", "core,search")')
     .option('--default-project <number>', 'Default GitHub Project number')
     .option('--auto-rebuild-index', 'Rebuild vector index on server startup')
     .option('--cors-origin <origin>', 'CORS allowed origin for HTTP transport (default: *)')
+    .option('--auth-token <token>', 'Bearer token for HTTP transport authentication (env: MCP_AUTH_TOKEN)')
     .option('--log-level <level>', 'Log level: debug, info, warning, error', 'info')
+    .option('--backup-interval <minutes>', 'Automated backup interval in minutes, HTTP only (0 = disabled)', '0')
+    .option('--keep-backups <count>', 'Max backups to retain during automated cleanup', '5')
+    .option('--vacuum-interval <minutes>', 'Database optimize interval in minutes, HTTP only (0 = disabled)', '0')
+    .option('--rebuild-index-interval <minutes>', 'Vector index rebuild interval in minutes, HTTP only (0 = disabled)', '0')
     .action(async (options) => {
     // Set log level
     logger.setLevel(options.logLevel);
@@ -30,6 +36,7 @@ program
         transport: options.transport,
         stateless: options.stateless ?? false,
         db: options.db,
+        ...(options.teamDb ? { teamDb: options.teamDb } : {}),
         ...(host ? { host } : {}),
     });
     try {
@@ -39,6 +46,7 @@ program
             host,
             statelessHttp: options.stateless === true,
             dbPath: options.db,
+            teamDbPath: options.teamDb,
             toolFilter: options.toolFilter,
             defaultProjectNumber: options.defaultProject
                 ? parseInt(options.defaultProject, 10)
@@ -47,6 +55,13 @@ program
                     : undefined,
             autoRebuildIndex: options.autoRebuildIndex ?? process.env['AUTO_REBUILD_INDEX'] === 'true',
             corsOrigin: options.corsOrigin,
+            authToken: options.authToken,
+            scheduler: {
+                backupIntervalMinutes: parseInt(options.backupInterval, 10),
+                keepBackups: parseInt(options.keepBackups, 10),
+                vacuumIntervalMinutes: parseInt(options.vacuumInterval, 10),
+                rebuildIndexIntervalMinutes: parseInt(options.rebuildIndexInterval, 10),
+            },
         });
     }
     catch (error) {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/constants/ServerInstructions.d.ts

@@ -1,10 +1,14 @@
 /**
  * Server instructions for Memory Journal MCP.
  *
+ * ⚠️  AUTO-GENERATED — DO NOT EDIT THIS FILE DIRECTLY
+ *     Edit src/constants/server-instructions.md instead,
+ *     then run: npm run generate:instructions
+ *
  * These instructions are automatically sent to MCP clients during initialization,
  * providing guidance for AI agents on tool usage.
  *
- * Unreleased: Optimized for token efficiency with tiered instruction levels.
+ * Optimized for token efficiency with tiered instruction levels.
  */
 /**
  * Resource definition for instruction generation

package/dist/constants/ServerInstructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerInstructions.d.ts","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAA;AAmOhE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,EAAE,kBAAkB,EAAE,EAChC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,CAAC,EAAE,mBAAmB,EACjC,KAAK,GAAE,gBAA6B,GACrC,MAAM,CAuCR;AAkBD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAA+C,CAAA"}
+{"version":3,"file":"ServerInstructions.d.ts","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAA;AA2RhE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,UAAU,EAAE,kBAAkB,EAAE,EAChC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,CAAC,EAAE,mBAAmB,EACjC,KAAK,GAAE,gBAA6B,GACrC,MAAM,CAuCR;AAkBD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAA+C,CAAA"}

package/dist/constants/ServerInstructions.js

@@ -1,10 +1,14 @@
 /**
  * Server instructions for Memory Journal MCP.
  *
+ * ⚠️  AUTO-GENERATED — DO NOT EDIT THIS FILE DIRECTLY
+ *     Edit src/constants/server-instructions.md instead,
+ *     then run: npm run generate:instructions
+ *
  * These instructions are automatically sent to MCP clients during initialization,
  * providing guidance for AI agents on tool usage.
  *
- * Unreleased: Optimized for token efficiency with tiered instruction levels.
+ * Optimized for token efficiency with tiered instruction levels.
  */
 import { TOOL_GROUPS } from '../filtering/ToolFilter.js';
 /**
@@ -14,29 +18,55 @@ import { TOOL_GROUPS } from '../filtering/ToolFilter.js';
 const ESSENTIAL_INSTRUCTIONS = `# memory-journal-mcp
 
 ## Session Start
+
 1. Read \`memory://briefing\` for project context
+   - In Cursor, use \`FetchMcpResource(server: "user-memory-journal-mcp", uri: "memory://briefing")\`
 2. **Show the \`userMessage\` to the user** (it contains a formatted summary of project context)
 3. Proceed with the user's request
 
 ## Behaviors
+
 - **Create entries for**: implementations, decisions, bug fixes, milestones, user requests to "remember"
 - **Search before**: major decisions, referencing prior work, understanding project context
 - **Link entries**: implementation→spec, bugfix→issue, followup→prior work
 
+## Session End
+
+When a conversation or task is wrapping up (user says "thanks," final deliverable complete, no more work planned):
+
+1. Create a journal entry summarizing the session:
+   - **What was accomplished** (key changes, decisions, files modified)
+   - **What's unfinished or blocked** (pending items, open questions)
+   - **Context for next session** (relevant entry IDs, branch names, PR numbers)
+2. Use \`entry_type: "retrospective"\` and tag with \`session-summary\`
+3. This is opt-out — ALWAYS create the entry, even for short/trivial sessions, unless the user explicitly says to skip it
+
+> If your client has hooks configured for session-end journaling (e.g., Cursor \`sessionEnd\` hook), this is handled automatically. Otherwise, follow the steps above.
+
+## Rule & Skill Suggestions
+
+When you notice the user consistently applies patterns, preferences, or workflows that could be codified:
+
+- **Offer to create a rule or skill** — always ask the user first, never create silently
+- Examples: coding conventions, testing patterns, deployment steps, project-specific commands
+- Frame it as: "I noticed you always [pattern]. Would you like me to save this as a rule/skill so future agents follow it automatically?"
+
 ## Quick Access
-| Purpose | Action |
-|---------|--------|
-| Session context | \`memory://briefing\` |
-| Recent entries | \`memory://recent\` |
-| Health/time | \`memory://health\` |
-| Semantic search | \`semantic_search(query)\` |
-| Full context | \`get-context-bundle\` prompt |
+
+| Purpose         | Action                      |
+| --------------- | --------------------------- |
+| Session context | \`memory://briefing\`         |
+| Recent entries  | \`memory://recent\`           |
+| Health/time     | \`memory://health\`           |
+| Semantic search | \`semantic_search(query)\`    |
+| Full context    | \`get-context-bundle\` prompt |
 `;
 /**
  * GitHub integration patterns (~150 additional tokens)
  */
 const GITHUB_INSTRUCTIONS = `
 ## GitHub Integration
+
 - Include \`issue_number\`/\`pr_number\` in \`create_entry\` to auto-link
 - After closing issue/merging PR → create summary entry with learnings
 - CI failures → \`actions-failure-digest\` prompt or \`memory://actions/recent\`
@@ -51,26 +81,34 @@ const SERVER_ACCESS_INSTRUCTIONS = `
 ## How to Access This Server
 
 ### Calling Tools
+
 Use \`CallMcpTool\` with server name \`user-memory-journal-mcp\`:
+
 \`\`\`
 CallMcpTool(server: "user-memory-journal-mcp", toolName: "create_entry", arguments: {...})
 \`\`\`
 
 ### Listing Resources
+
 Use \`ListMcpResources\` with server name:
+
 \`\`\`
 ListMcpResources(server: "user-memory-journal-mcp")
 \`\`\`
+
 Do NOT try to browse filesystem paths for MCP tool/resource definitions - use the MCP protocol directly.
 
 ### Fetching Resources
+
 Use \`FetchMcpResource\` with server name and \`memory://\` URI:
+
 \`\`\`
 FetchMcpResource(server: "user-memory-journal-mcp", uri: "memory://recent")
 FetchMcpResource(server: "user-memory-journal-mcp", uri: "memory://kanban/1")
 \`\`\`
 
 ## Quick Health Check
+
 Fetch \`memory://health\` to verify server status, database stats, and tool availability.
 `;
 /**
@@ -80,57 +118,64 @@ const TOOL_PARAMETER_REFERENCE = `
 ## Tool Parameter Reference
 
 ### Entry Operations
-| Tool | Required Parameters | Optional Parameters |
-|------|---------------------|---------------------|
-| \`create_entry\` | \`content\` (string) | \`entry_type\`, \`tags\` (array), \`is_personal\`, \`significance_type\`, \`share_with_team\`, \`auto_context\`, \`issue_number\`, \`issue_url\`, \`pr_number\`, \`pr_url\`, \`pr_status\`, \`project_number\`, \`project_owner\`, \`workflow_run_id\`, \`workflow_name\`, \`workflow_status\` |
-| \`create_entry_minimal\` | \`content\` (string) | none |
-| \`get_entry_by_id\` | \`entry_id\` (number) | \`include_relationships\` (bool, default true) |
-| \`get_recent_entries\` | none | \`limit\` (default 5), \`is_personal\` (bool) |
-| \`update_entry\` | \`entry_id\` (number) | \`content\`, \`tags\`, \`entry_type\`, \`is_personal\` |
-| \`delete_entry\` | \`entry_id\` (number) | \`permanent\` (bool, default false) |
-| \`list_tags\` | none | none |
+
+| Tool                   | Required Parameters | Optional Parameters                                                                                                                                                                                                                         |
+| ---------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| \`create_entry\`         | \`content\` (string)  | \`entry_type\`, \`tags\` (array), \`is_personal\`, \`significance_type\`, \`auto_context\`, \`issue_number\`, \`issue_url\`, \`pr_number\`, \`pr_url\`, \`pr_status\`, \`project_number\`, \`project_owner\`, \`workflow_run_id\`, \`workflow_name\`, \`workflow_status\` |
+| \`create_entry_minimal\` | \`content\` (string)  | none                                                                                                                                                                                                                                        |
+| \`get_entry_by_id\`      | \`entry_id\` (number) | \`include_relationships\` (bool, default true)                                                                                                                                                                                                |
+| \`get_recent_entries\`   | none                | \`limit\` (default 5), \`is_personal\` (bool)                                                                                                                                                                                                   |
+| \`update_entry\`         | \`entry_id\` (number) | \`content\`, \`tags\`, \`entry_type\`, \`is_personal\`                                                                                                                                                                                              |
+| \`delete_entry\`         | \`entry_id\` (number) | \`permanent\` (bool, default false)                                                                                                                                                                                                           |
+| \`list_tags\`            | none                | none                                                                                                                                                                                                                                        |
 
 ### Search Tools
-| Tool | Required Parameters | Optional Parameters |
-|------|---------------------|---------------------|
-| \`search_entries\` | none | \`query\`, \`limit\`, \`is_personal\`, \`issue_number\`, \`pr_number\`, \`pr_status\`, \`project_number\`, \`workflow_run_id\` |
-| \`search_by_date_range\` | \`start_date\`, \`end_date\` (YYYY-MM-DD) | \`tags\`, \`entry_type\`, \`is_personal\`, \`issue_number\`, \`pr_number\`, \`project_number\`, \`workflow_run_id\` |
-| \`semantic_search\` | \`query\` (string) | \`limit\`, \`similarity_threshold\` (default 0.25), \`is_personal\`, \`hint_on_empty\` (bool, default true) |
-| \`get_vector_index_stats\` | none | none |
+
+| Tool                     | Required Parameters                   | Optional Parameters                                                                                            |
+| ------------------------ | ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| \`search_entries\`         | none                                  | \`query\`, \`limit\`, \`is_personal\`, \`issue_number\`, \`pr_number\`, \`pr_status\`, \`project_number\`, \`workflow_run_id\` |
+| \`search_by_date_range\`   | \`start_date\`, \`end_date\` (YYYY-MM-DD) | \`tags\`, \`entry_type\`, \`is_personal\`, \`issue_number\`, \`pr_number\`, \`project_number\`, \`workflow_run_id\`          |
+| \`semantic_search\`        | \`query\` (string)                      | \`limit\`, \`similarity_threshold\` (default 0.25), \`is_personal\`, \`hint_on_empty\` (bool, default true)            |
+| \`get_vector_index_stats\` | none                                  | none                                                                                                           |
 
 ### Relationship Tools
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`link_entries\` | \`from_entry_id\`, \`to_entry_id\` (numbers) | Types: \`evolves_from\`, \`references\`, \`implements\`, \`clarifies\`, \`response_to\`, \`blocked_by\`, \`resolved\`, \`caused\`. Optional \`description\`. |
-| \`visualize_relationships\` | none | Optional \`entry_id\`, \`tags\` (array), \`depth\` (1-3, default 2), \`limit\` (default 20). Returns Mermaid diagram. |
+
+| Tool                      | Required Parameters                      | Notes                                                                                                                                      |
+| ------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| \`link_entries\`            | \`from_entry_id\`, \`to_entry_id\` (numbers) | Types: \`evolves_from\`, \`references\`, \`implements\`, \`clarifies\`, \`response_to\`, \`blocked_by\`, \`resolved\`, \`caused\`. Optional \`description\`. |
+| \`visualize_relationships\` | none                                     | Optional \`entry_id\`, \`tags\` (array), \`depth\` (1-3, default 2), \`limit\` (default 20). Returns Mermaid diagram.                              |
 
 ### GitHub Tools
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`get_github_context\` | none | Returns repo info, open issues/PRs. Only counts OPEN items. |
-| \`get_github_issues\` | none | Optional \`state\` (open/closed/all), \`limit\`, \`owner\`, \`repo\` |
-| \`get_github_prs\` | none | Optional \`state\`, \`limit\`, \`owner\`, \`repo\` |
-| \`get_github_issue\` | \`issue_number\` (number) | Optional \`owner\`, \`repo\`. Fetches single issue details. |
-| \`get_github_pr\` | \`pr_number\` (number) | Optional \`owner\`, \`repo\`. Fetches single PR details. |
-| \`get_repo_insights\` | none | Optional \`sections\` (stars/traffic/referrers/paths/all, default "stars"), \`owner\`, \`repo\`. Requires push access for traffic. |
+
+| Tool                 | Required Parameters     | Notes                                                                                                                        |
+| -------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| \`get_github_context\` | none                    | Returns repo info, open issues/PRs. Only counts OPEN items.                                                                  |
+| \`get_github_issues\`  | none                    | Optional \`state\` (open/closed/all), \`limit\`, \`owner\`, \`repo\`                                                                 |
+| \`get_github_prs\`     | none                    | Optional \`state\`, \`limit\`, \`owner\`, \`repo\`                                                                                   |
+| \`get_github_issue\`   | \`issue_number\` (number) | Optional \`owner\`, \`repo\`. Fetches single issue details.                                                                      |
+| \`get_github_pr\`      | \`pr_number\` (number)    | Optional \`owner\`, \`repo\`. Fetches single PR details.                                                                         |
+| \`get_repo_insights\`  | none                    | Optional \`sections\` (stars/traffic/referrers/paths/all, default "stars"), \`owner\`, \`repo\`. Requires push access for traffic. |
 
 GitHub tools auto-detect owner/repo from GITHUB_REPO_PATH. If \`detectedOwner\`/\`detectedRepo\` are null in response, specify \`owner\` and \`repo\` parameters explicitly.
 
 ### Issue Lifecycle Tools
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`create_github_issue_with_entry\` | \`title\` (string) | Optional \`body\`, \`labels\` (array), \`assignees\` (array), \`project_number\`, \`initial_status\`, \`milestone_number\`, \`entry_content\`, \`tags\`, \`owner\`, \`repo\` |
-| \`close_github_issue_with_entry\` | \`issue_number\` (number) | Optional \`comment\`, \`resolution_notes\`, \`tags\`, \`move_to_done\` (bool), \`project_number\`, \`owner\`, \`repo\` |
+
+| Tool                             | Required Parameters     | Notes                                                                                                                                                    |
+| -------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| \`create_github_issue_with_entry\` | \`title\` (string)        | Optional \`body\`, \`labels\` (array), \`assignees\` (array), \`project_number\`, \`initial_status\`, \`milestone_number\`, \`entry_content\`, \`tags\`, \`owner\`, \`repo\` |
+| \`close_github_issue_with_entry\`  | \`issue_number\` (number) | Optional \`comment\`, \`resolution_notes\`, \`tags\`, \`move_to_done\` (bool), \`project_number\`, \`owner\`, \`repo\`                                                 |
 
 ### Kanban Tools (GitHub Projects v2)
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`get_kanban_board\` | \`project_number\` (number) | Optional \`owner\`. Returns columns with items grouped by Status |
+
+| Tool               | Required Parameters                                            | Notes                                                                                                     |
+| ------------------ | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| \`get_kanban_board\` | \`project_number\` (number)                                      | Optional \`owner\`. Returns columns with items grouped by Status                                            |
 | \`move_kanban_item\` | \`project_number\`, \`item_id\` (string), \`target_status\` (string) | Optional \`owner\`. \`item_id\` is the GraphQL node ID from board items. Status matching is case-insensitive. |
 
 **Finding the right project**: User may have multiple projects. Use \`get_kanban_board\` with different project numbers (1, 2, 3...) to find the correct one by checking \`projectTitle\`.
 
 **Default Status columns** (typical GitHub Projects v2):
+
 - \`Backlog\` - Items not yet started
 - \`Ready\` - Ready to be picked up
 - \`In progress\` - Actively being worked on
@@ -140,39 +185,46 @@ GitHub tools auto-detect owner/repo from GITHUB_REPO_PATH. If \`detectedOwner\`/
 Note: Status columns are dynamic per project. The \`statusOptions\` in the response shows available statuses for that specific project.
 
 Kanban resources:
+
 - \`memory://kanban/{project_number}\` - JSON board data
 - \`memory://kanban/{project_number}/diagram\` - Mermaid visualization
 
 ### Milestone Tools
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`get_github_milestones\` | none | Optional \`state\` (open/closed/all), \`limit\`, \`owner\`, \`repo\` |
-| \`get_github_milestone\` | \`milestone_number\` (number) | Optional \`owner\`, \`repo\`. Single milestone with completion %. |
-| \`create_github_milestone\` | \`title\` (string) | Optional \`description\`, \`due_on\` (YYYY-MM-DD), \`owner\`, \`repo\` |
-| \`update_github_milestone\` | \`milestone_number\` (number) | Optional \`title\`, \`description\`, \`due_on\`, \`state\` (open/closed), \`owner\`, \`repo\` |
-| \`delete_github_milestone\` | \`milestone_number\`, \`confirm: true\` | Optional \`owner\`, \`repo\`. Permanent deletion. |
+
+| Tool                      | Required Parameters                 | Notes                                                                             |
+| ------------------------- | ----------------------------------- | --------------------------------------------------------------------------------- |
+| \`get_github_milestones\`   | none                                | Optional \`state\` (open/closed/all), \`limit\`, \`owner\`, \`repo\`                      |
+| \`get_github_milestone\`    | \`milestone_number\` (number)         | Optional \`owner\`, \`repo\`. Single milestone with completion %.                     |
+| \`create_github_milestone\` | \`title\` (string)                    | Optional \`description\`, \`due_on\` (YYYY-MM-DD), \`owner\`, \`repo\`                    |
+| \`update_github_milestone\` | \`milestone_number\` (number)         | Optional \`title\`, \`description\`, \`due_on\`, \`state\` (open/closed), \`owner\`, \`repo\` |
+| \`delete_github_milestone\` | \`milestone_number\`, \`confirm: true\` | Optional \`owner\`, \`repo\`. Permanent deletion.                                     |
 
 Milestone resources:
+
 - \`memory://github/milestones\` - Open milestones with completion %
 - \`memory://milestones/{number}\` - Single milestone detail
 
 ### Admin Tools
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`backup_journal\` | none | Optional \`name\` (custom backup name) |
-| \`list_backups\` | none | Returns available backup files |
-| \`cleanup_backups\` | none | Optional \`keep_count\` (default 5). Deletes old backups, keeps N most recent. |
-| \`restore_backup\` | \`filename\`, \`confirm: true\` | Creates auto-backup before restore |
-| \`add_to_vector_index\` | \`entry_id\` (single number) | Indexes one entry for semantic search |
-| \`rebuild_vector_index\` | none | Re-indexes all entries |
+
+| Tool                   | Required Parameters         | Notes                                                                        |
+| ---------------------- | --------------------------- | ---------------------------------------------------------------------------- |
+| \`backup_journal\`       | none                        | Optional \`name\` (custom backup name)                                         |
+| \`list_backups\`         | none                        | Returns available backup files                                               |
+| \`cleanup_backups\`      | none                        | Optional \`keep_count\` (default 5). Deletes old backups, keeps N most recent. |
+| \`restore_backup\`       | \`filename\`, \`confirm: true\` | Creates auto-backup before restore                                           |
+| \`add_to_vector_index\`  | \`entry_id\` (single number)  | Indexes one entry for semantic search                                        |
+| \`rebuild_vector_index\` | none                        | Re-indexes all entries                                                       |
 
 ### Export Tools
-| Tool | Required Parameters | Notes |
-|------|---------------------|-------|
-| \`export_entries\` | none | Optional \`format\` (json/markdown), \`limit\` (default 100), \`tags\`, \`start_date\`, \`end_date\`, \`entry_types\` |
+
+| Tool             | Required Parameters | Notes                                                                                                     |
+| ---------------- | ------------------- | --------------------------------------------------------------------------------------------------------- |
+| \`export_entries\` | none                | Optional \`format\` (json/markdown), \`limit\` (default 100), \`tags\`, \`start_date\`, \`end_date\`, \`entry_types\` |
 
 ## Entry Types
+
 Valid values for \`entry_type\` parameter:
+
 - \`personal_reflection\` (default) - Personal thoughts and notes
 - \`project_decision\` - Architectural and team decisions
 - \`technical_achievement\` - Milestones and breakthroughs
@@ -185,9 +237,16 @@ Valid values for \`entry_type\` parameter:
 - \`planning\` - Planning sessions and roadmaps (\`create_github_issue_with_entry\` uses this type)
 - \`retrospective\` - Sprint and project retrospectives
 - \`standup\` - Daily standup notes
+- \`technical_note\` - Technical notes and observations
+- \`development_note\` - Development process notes
+- \`enhancement\` - Enhancement tracking
+- \`milestone\` - Milestone documentation
+- \`system_integration_test\` - Integration test records
+- \`test_entry\` - Test and scratch entries
 - \`other\` - Miscellaneous
 
 ## Field Notes
+
 - **\`autoContext\`**: Reserved for future automatic context capture. Currently always \`null\`.
 - **\`memory://tags\` vs \`list_tags\`**: Resource includes \`id\`, \`name\`, \`count\`; tool returns only \`name\`, \`count\`. Neither returns orphan tags with zero usage.
 - **Tag naming**: Use lowercase with dashes (e.g., \`bug-fix\`, \`phase-2\`). Use \`merge_tags\` to consolidate duplicates (e.g., merge \`phase2\` into \`phase-2\`).
@@ -204,19 +263,20 @@ Valid values for \`entry_type\` parameter:
 - **\`delete_entry\` on soft-deleted**: \`delete_entry(id, permanent: true)\` works on previously soft-deleted entries. Returns \`success: false\` for nonexistent entries.
 
 ## Key Resources
-| URI | Description |
-|-----|-------------|
-| \`memory://health\` | Server health, DB stats, tool filter status |
-| \`memory://briefing\` | Session context with userMessage to show user |
-| \`memory://instructions\` | Full server instructions and tool reference |
-| \`memory://statistics\` | Entry counts by type and period |
-| \`memory://recent\` | 10 most recent entries |
-| \`memory://tags\` | All tags with usage counts |
-| \`memory://significant\` | Entries sorted by importance score |
-| \`memory://graph/recent\` | Mermaid diagram of recent relationships |
-| \`memory://graph/actions\` | CI/CD narrative graph |
-| \`memory://actions/recent\` | Recent workflow runs |
-| \`memory://team/recent\` | Team-shared entries |
+
+| URI                       | Description                                   |
+| ------------------------- | --------------------------------------------- |
+| \`memory://health\`         | Server health, DB stats, tool filter status   |
+| \`memory://briefing\`       | Session context with userMessage to show user |
+| \`memory://instructions\`   | Full server instructions and tool reference   |
+| \`memory://statistics\`     | Entry counts by type and period               |
+| \`memory://recent\`         | 10 most recent entries                        |
+| \`memory://tags\`           | All tags with usage counts                    |
+| \`memory://significant\`    | Entries sorted by importance score            |
+| \`memory://graph/recent\`   | Mermaid diagram of recent relationships       |
+| \`memory://graph/actions\`  | CI/CD narrative graph                         |
+| \`memory://actions/recent\` | Recent workflow runs                          |
+
 | \`memory://github/status\` | GitHub repo overview (CI, issues, PRs, milestones) |
 | \`memory://github/milestones\` | Open milestones with completion % |
 | \`memory://github/insights\` | Stars, forks, and 14-day traffic summary |

package/dist/constants/ServerInstructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServerInstructions.js","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAqCxD;;;GAGG;AACH,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;CAoB9B,CAAA;AAED;;GAEG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;CAQ3B,CAAA;AAED;;GAEG;AACH,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlC,CAAA;AAED;;GAEG;AACH,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuJhC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAChC,YAAyB,EACzB,UAAgC,EAChC,OAA2B,EAC3B,WAAiC,EACjC,QAA0B,UAAU;IAEpC,IAAI,YAAY,GAAG,sBAAsB,CAAA;IAEzC,mEAAmE;IACnE,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACjD,YAAY,IAAI,kBAAkB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,WAAW,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS,OAAO,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAA;IAClL,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,YAAY,IAAI,mBAAmB,CAAA;IACvC,CAAC;IAED,8EAA8E;IAC9E,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACnB,YAAY,IAAI,0BAA0B,CAAA;QAC1C,YAAY,IAAI,wBAAwB,CAAA;QAExC,2BAA2B;QAC3B,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAA;QACtD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,YAAY,IAAI,sBAAsB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAA;YACpE,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC1C,YAAY,IAAI,KAAK,KAAK,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;YAChF,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,YAAY,IAAI,iBAAiB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAA;YAC5D,YAAY,IAAI,6CAA6C,CAAA;YAC7D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC3B,YAAY,IAAI,OAAO,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,WAAW,IAAI,EAAE,IAAI,CAAA;YAC1E,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAA;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,YAAyB;IAClD,MAAM,YAAY,GAA4C,EAAE,CAAA;IAEhE,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAA4B,EAAE,CAAC;QACrF,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;QACxE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAA;QACvD,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,mBAAmB,CAAA"}
+{"version":3,"file":"ServerInstructions.js","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"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"}

package/dist/constants/icons.d.ts

@@ -23,6 +23,8 @@ export declare const ICON_ADMIN: McpIcon;
 export declare const ICON_GITHUB: McpIcon;
 /** Archive/box for backup */
 export declare const ICON_BACKUP: McpIcon;
+/** Users group for team collaboration */
+export declare const ICON_TEAM: McpIcon;
 /** Document for briefing/instructions */
 export declare const ICON_BRIEFING: McpIcon;
 /** Network/share for graph resources */
@@ -37,8 +39,6 @@ export declare const ICON_KANBAN: McpIcon;
 export declare const ICON_STAR: McpIcon;
 /** Tag for tags resource */
 export declare const ICON_TAG: McpIcon;
-/** Users for team resources */
-export declare const ICON_TEAM: McpIcon;
 /** Issue icon for GitHub issues */
 export declare const ICON_ISSUE: McpIcon;
 /** Git merge for PR resources */

package/dist/constants/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/constants/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAMhD,gDAAgD;AAChD,eAAO,MAAM,SAAS,EAAE,OAIvB,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,8BAA8B;AAC9B,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,kBAAkB,EAAE,OAIhC,CAAA;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAMD,yCAAyC;AACzC,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,0CAA0C;AAC1C,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,SAAS,EAAE,OAIvB,CAAA;AAED,4BAA4B;AAC5B,eAAO,MAAM,QAAQ,EAAE,OAItB,CAAA;AAED,+BAA+B;AAC/B,eAAO,MAAM,SAAS,EAAE,OAIvB,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,OAAO,EAAE,OAIrB,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAMD,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CASpD,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,SAAS,CAGhE"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/constants/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAMhD,gDAAgD;AAChD,eAAO,MAAM,SAAS,EAAE,OAIvB,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,8BAA8B;AAC9B,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,kBAAkB,EAAE,OAIhC,CAAA;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,SAAS,EAAE,OAIvB,CAAA;AAMD,yCAAyC;AACzC,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,0CAA0C;AAC1C,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,SAAS,EAAE,OAIvB,CAAA;AAED,4BAA4B;AAC5B,eAAO,MAAM,QAAQ,EAAE,OAItB,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,UAAU,EAAE,OAIxB,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,OAAO,EAAE,OAIrB,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,WAAW,EAAE,OAIzB,CAAA;AAMD,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAUpD,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,SAAS,CAGhE"}

package/dist/constants/icons.js

@@ -57,6 +57,12 @@ export const ICON_BACKUP = {
     mimeType: 'image/svg+xml',
     sizes: ['24x24'],
 };
+/** Users group for team collaboration */
+export const ICON_TEAM = {
+    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M17 21v-2a4 4 0 00-4-4H5a4 4 0 00-4 4v2"/%3E%3Ccircle cx="9" cy="7" r="4"/%3E%3Cpath d="M23 21v-2a4 4 0 00-3-3.87"/%3E%3Cpath d="M16 3.13a4 4 0 010 7.75"/%3E%3C/svg%3E',
+    mimeType: 'image/svg+xml',
+    sizes: ['24x24'],
+};
 // ============================================================================
 // Resource Icons
 // ============================================================================
@@ -102,12 +108,6 @@ export const ICON_TAG = {
     mimeType: 'image/svg+xml',
     sizes: ['24x24'],
 };
-/** Users for team resources */
-export const ICON_TEAM = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M17 21v-2a4 4 0 00-4-4H5a4 4 0 00-4 4v2"/%3E%3Ccircle cx="9" cy="7" r="4"/%3E%3Cpath d="M23 21v-2a4 4 0 00-3-3.87"/%3E%3Cpath d="M16 3.13a4 4 0 010 7.75"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-};
 /** Issue icon for GitHub issues */
 export const ICON_ISSUE = {
     src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="12" cy="12" r="10"/%3E%3Cline x1="12" y1="8" x2="12" y2="12"/%3E%3Cline x1="12" y1="16" x2="12.01" y2="16"/%3E%3C/svg%3E',
@@ -145,6 +145,7 @@ export const TOOL_GROUP_ICONS = {
     admin: ICON_ADMIN,
     github: ICON_GITHUB,
     backup: ICON_BACKUP,
+    team: ICON_TEAM,
 };
 /**
  * Get icons array for a tool based on its group