mcp-config-manager 2.1.0 → 2.3.0

package/src/skills-scopes.js

@@ -0,0 +1,809 @@
+import path from 'path';
+import os from 'os';
+
+/**
+ * Skills/prompts/rules configuration per client.
+ * Each client can have multiple "tabs" for different types of customizations.
+ */
+
+const homedir = os.homedir();
+const platform = os.platform();
+
+// Platform-specific paths for VS Code extensions
+const getVSCodePath = () => {
+  if (platform === 'darwin') {
+    return path.join(homedir, 'Library/Application Support/Code/User');
+  } else if (platform === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Code/User');
+  }
+  return path.join(homedir, '.config/Code/User');
+};
+
+// Platform-specific paths for Cline rules
+const getClinePath = () => {
+  if (platform === 'darwin') {
+    return path.join(homedir, 'Documents', 'Cline', 'Rules');
+  } else if (platform === 'win32') {
+    return path.join(process.env.USERPROFILE || homedir, 'Documents', 'Cline', 'Rules');
+  }
+  return path.join(homedir, 'Documents', 'Cline', 'Rules');
+};
+
+/**
+ * Client-specific skill/prompt configurations
+ * Each client can have multiple tabs for different content types
+ */
+export const CLIENT_SKILLS = {
+  // ============================================
+  // CLAUDE CODE - Skills, Commands & Agents
+  // ============================================
+  'claude-code': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🎭',
+        path: path.join(homedir, '.claude', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Modular expertise modules'
+      },
+      {
+        id: 'commands',
+        name: 'Commands',
+        icon: '⚡',
+        path: path.join(homedir, '.claude', 'commands'),
+        format: 'command-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Slash commands for quick prompts'
+      },
+      {
+        id: 'agents',
+        name: 'Agents',
+        icon: '🤖',
+        path: path.join(homedir, '.claude', 'agents'),
+        format: 'agent-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Custom subagents with YAML frontmatter'
+      }
+    ]
+  },
+
+  // ============================================
+  // CURSOR - Rules
+  // ============================================
+  'cursor': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '📐',
+        path: path.join(homedir, '.cursor', 'rules'),
+        format: 'mdc',
+        filePattern: '*.mdc',
+        supportsDirectories: false,
+        description: 'Global rules for Cursor AI'
+      }
+    ]
+  },
+
+  // ============================================
+  // CONTINUE.DEV - Prompts & Rules
+  // ============================================
+  'continue': {
+    tabs: [
+      {
+        id: 'prompts',
+        name: 'Prompts',
+        icon: '▶️',
+        path: path.join(homedir, '.continue', 'prompts'),
+        format: 'prompt-md',
+        filePattern: '*.prompt',
+        supportsDirectories: false,
+        description: 'Slash command prompts'
+      },
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '📏',
+        path: path.join(homedir, '.continue', 'rules'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Context rules'
+      }
+    ]
+  },
+
+  // ============================================
+  // WINDSURF (CODEIUM) - Rules
+  // ============================================
+  'windsurf': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🏄',
+        path: path.join(homedir, '.codeium', 'windsurf', 'memories'),
+        format: 'rule-md',
+        filePattern: 'global_rules.md',
+        singleFile: true,
+        supportsDirectories: false,
+        description: 'Rules for Windsurf AI'
+      }
+    ]
+  },
+
+  // ============================================
+  // GITHUB COPILOT - Instructions & Skills
+  // NOTE: Per-repo instructions live in .github/copilot-instructions.md
+  // Per-repo skills in .github/skills/. User-level skills at ~/.copilot/skills/
+  // ============================================
+  'github-copilot': {
+    tabs: [
+      {
+        id: 'instructions',
+        name: 'Instructions',
+        icon: '🐙',
+        path: path.join(homedir, '.github'),
+        format: 'instructions-md',
+        filePattern: 'copilot-instructions.md',
+        singleFile: true,
+        supportsDirectories: false,
+        description: 'Global instructions for Copilot'
+      },
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🎯',
+        path: path.join(homedir, '.copilot', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Personal agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // VS CODE (with Continue extension)
+  // ============================================
+  'vscode': {
+    tabs: [
+      {
+        id: 'prompts',
+        name: 'Prompts',
+        icon: '▶️',
+        path: path.join(homedir, '.continue', 'prompts'),
+        format: 'prompt-md',
+        filePattern: '*.prompt',
+        supportsDirectories: false,
+        description: 'Continue.dev prompts'
+      },
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '📏',
+        path: path.join(homedir, '.continue', 'rules'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Continue.dev rules'
+      }
+    ]
+  },
+
+  // ============================================
+  // AMAZON Q DEVELOPER - Rules
+  // NOTE: Project-scoped rules live in .amazonq/rules/ at the repo root.
+  // The global path below (~/.aws/amazonq/rules) may not exist on all setups.
+  // ============================================
+  'amazonq': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🔶',
+        path: path.join(homedir, '.aws', 'amazonq', 'rules'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Rules for Amazon Q'
+      }
+    ]
+  },
+
+  // ============================================
+  // CLINE - Rules
+  // ============================================
+  'cline': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🔧',
+        path: getClinePath(),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Global rules for Cline'
+      }
+    ]
+  },
+
+  // ============================================
+  // ROO CODE - Rules
+  // ============================================
+  'roo-code': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🦘',
+        path: path.join(homedir, '.roo', 'rules'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Global rules for Roo Code'
+      }
+    ]
+  },
+
+  // ============================================
+  // GEMINI CLI - Context, Commands & Skills
+  // ============================================
+  'gemini': {
+    tabs: [
+      {
+        id: 'context',
+        name: 'Context',
+        icon: '💎',
+        path: path.join(homedir, '.gemini'),
+        format: 'context-md',
+        filePattern: 'GEMINI.md',
+        singleFile: true,
+        supportsDirectories: false,
+        description: 'Global context (GEMINI.md)'
+      },
+      {
+        id: 'commands',
+        name: 'Commands',
+        icon: '✨',
+        path: path.join(homedir, '.gemini', 'commands'),
+        format: 'command-toml',
+        filePattern: '*.toml',
+        supportsDirectories: false,
+        description: 'Custom commands'
+      },
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🎯',
+        path: path.join(homedir, '.gemini', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // GOOGLE ANTIGRAVITY - Same as Gemini
+  // ============================================
+  'google-antigravity': {
+    tabs: [
+      {
+        id: 'context',
+        name: 'Context',
+        icon: '💎',
+        path: path.join(homedir, '.gemini'),
+        format: 'context-md',
+        filePattern: 'GEMINI.md',
+        singleFile: true,
+        supportsDirectories: false,
+        description: 'Global context (GEMINI.md)'
+      },
+      {
+        id: 'commands',
+        name: 'Commands',
+        icon: '✨',
+        path: path.join(homedir, '.gemini', 'commands'),
+        format: 'command-toml',
+        filePattern: '*.toml',
+        supportsDirectories: false,
+        description: 'Custom commands'
+      },
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🎯',
+        path: path.join(homedir, '.gemini', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // CODEX (OPENAI) - Agents & Skills
+  // ============================================
+  'codex': {
+    tabs: [
+      {
+        id: 'agents',
+        name: 'Agents',
+        icon: '🧠',
+        path: path.join(homedir, '.codex'),
+        format: 'agents-md',
+        filePattern: 'AGENTS.md',
+        singleFile: true,
+        supportsDirectories: false,
+        description: 'Agent instructions (AGENTS.md)'
+      },
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🧠',
+        path: path.join(homedir, '.codex', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md)'
+      }
+    ]
+  },
+
+  // ============================================
+  // JETBRAINS AI - Rules
+  // ============================================
+  'jetbrains-ai': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🧩',
+        path: path.join(homedir, '.aiassistant', 'rules'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Rules for JetBrains AI Assistant'
+      }
+    ]
+  },
+
+  // ============================================
+  // AUGMENT CODE - Commands & Rules
+  // NOTE: Rules are workspace-level (.augment/rules/), commands are user-level
+  // ============================================
+  'augment': {
+    tabs: [
+      {
+        id: 'commands',
+        name: 'Commands',
+        icon: '⚡',
+        path: path.join(homedir, '.augment', 'commands'),
+        format: 'command-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'User-wide commands for Augment Code'
+      },
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🔮',
+        path: path.join(homedir, '.augment', 'rules'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Rules for Augment Code'
+      }
+    ]
+  },
+
+  // ============================================
+  // TABNINE - Guidelines
+  // ============================================
+  'tabnine': {
+    tabs: [
+      {
+        id: 'guidelines',
+        name: 'Guidelines',
+        icon: '📋',
+        path: path.join(homedir, '.tabnine', 'guidelines'),
+        format: 'rule-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Guidelines for Tabnine'
+      }
+    ]
+  },
+
+  // ============================================
+  // ZED AI - No global skills support
+  // NOTE: Zed uses project-root .rules file for per-project config
+  // Rules Library stored in LMDB at ~/.config/zed/prompts/ (not editable)
+  // ============================================
+  'zed': {
+    tabs: []
+  },
+
+  // ============================================
+  // AIDER - Conventions
+  // NOTE: Config lives in ~/.aider.conf.yml. Conventions loaded via --read flag.
+  // ============================================
+  'aider': {
+    tabs: [
+      {
+        id: 'config',
+        name: 'Config',
+        icon: '🔧',
+        path: homedir,
+        format: 'yaml',
+        filePattern: '.aider.conf.yml',
+        singleFile: true,
+        supportsDirectories: false,
+        description: 'Global aider configuration'
+      }
+    ]
+  },
+
+  // ============================================
+  // 5IRE - No known skills support
+  // ============================================
+  '5ire': {
+    tabs: []
+  },
+
+  // ============================================
+  // FACTORY BRIDGE - No known skills support
+  // ============================================
+  'factory-bridge': {
+    tabs: []
+  },
+
+  // ============================================
+  // CLAUDE DESKTOP - Skills, Commands & Agents (same as Claude Code)
+  // ============================================
+  'claude': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🎭',
+        path: path.join(homedir, '.claude', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Modular expertise modules'
+      },
+      {
+        id: 'commands',
+        name: 'Commands',
+        icon: '⚡',
+        path: path.join(homedir, '.claude', 'commands'),
+        format: 'command-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Slash commands for quick prompts'
+      },
+      {
+        id: 'agents',
+        name: 'Agents',
+        icon: '🤖',
+        path: path.join(homedir, '.claude', 'agents'),
+        format: 'agent-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Custom subagents with YAML frontmatter'
+      }
+    ]
+  },
+
+  // ============================================
+  // FIREBENDER - Rules (JetBrains/Android Studio plugin)
+  // Personal rules at ~/.firebender/rules/*.mdc
+  // ============================================
+  'firebender': {
+    tabs: [
+      {
+        id: 'rules',
+        name: 'Rules',
+        icon: '🔥',
+        path: path.join(homedir, '.firebender', 'rules'),
+        format: 'mdc',
+        filePattern: '*.mdc',
+        supportsDirectories: false,
+        description: 'Personal rules for Firebender'
+      }
+    ]
+  },
+
+  // ============================================
+  // GOOSE (Block) - Skills
+  // User-level at ~/.config/goose/skills/ and ~/.config/agents/skills/
+  // ============================================
+  'goose': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🪿',
+        path: path.join(homedir, '.config', 'goose', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Goose-specific agent skills (SKILL.md)'
+      }
+    ]
+  },
+
+  // ============================================
+  // AMP (Sourcegraph) - Skills
+  // User-level at ~/.config/agents/skills/
+  // ============================================
+  'amp': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '⚡',
+        path: path.join(homedir, '.config', 'agents', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // OPENCODE - Skills & Agents
+  // User-level at ~/.config/opencode/skills/
+  // ============================================
+  'opencode': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '💻',
+        path: path.join(homedir, '.config', 'opencode', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // MISTRAL VIBE - Skills & Agents
+  // Skills at ~/.vibe/skills/, Agents at ~/.vibe/agents/
+  // ============================================
+  'mistral-vibe': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🌀',
+        path: path.join(homedir, '.vibe', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      },
+      {
+        id: 'agents',
+        name: 'Agents',
+        icon: '🤖',
+        path: path.join(homedir, '.vibe', 'agents'),
+        format: 'agent-toml',
+        filePattern: '*.toml',
+        supportsDirectories: false,
+        description: 'Custom agent profiles (.toml)'
+      }
+    ]
+  },
+
+  // ============================================
+  // PI CODING AGENT - Skills
+  // User-level at ~/.pi/agent/skills/
+  // ============================================
+  'pi': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🥧',
+        path: path.join(homedir, '.pi', 'agent', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // AUTOHAND CODE CLI - Skills
+  // User-level at ~/.autohand/skills/
+  // ============================================
+  'autohand': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🤚',
+        path: path.join(homedir, '.autohand', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Agent skills (SKILL.md in subdirs)'
+      }
+    ]
+  },
+
+  // ============================================
+  // TRAE (ByteDance) - Rules
+  // NOTE: Project-level rules at .trae/rules/. Global path not yet confirmed.
+  // ============================================
+  'trae': {
+    tabs: []
+  },
+
+  // ============================================
+  // LETTA CODE - Skills
+  // NOTE: Uses .skills/ at project level. Memory-first agent with Context Repos.
+  // ============================================
+  'letta': {
+    tabs: []
+  },
+
+  // ============================================
+  // QODO - Rules & Agents
+  // NOTE: Uses TOML-based agent configs. No confirmed global user-level path.
+  // ============================================
+  'qodo': {
+    tabs: []
+  },
+
+  // ============================================
+  // VT CODE - Skills
+  // NOTE: Follows Agent Skills standard but no confirmed global path.
+  // ============================================
+  'vt-code': {
+    tabs: []
+  },
+
+  // ============================================
+  // COMMAND CODE
+  // NOTE: No confirmed skills path.
+  // ============================================
+  'command-code': {
+    tabs: []
+  },
+
+  // ============================================
+  // PIEBALD - Uses Claude Code paths (desktop app wrapper)
+  // ============================================
+  'piebald': {
+    tabs: [
+      {
+        id: 'skills',
+        name: 'Skills',
+        icon: '🎭',
+        path: path.join(homedir, '.claude', 'skills'),
+        format: 'skill-md',
+        filePattern: '*.md',
+        supportsDirectories: true,
+        description: 'Claude Code skills'
+      },
+      {
+        id: 'agents',
+        name: 'Agents',
+        icon: '🤖',
+        path: path.join(homedir, '.claude', 'agents'),
+        format: 'agent-md',
+        filePattern: '*.md',
+        supportsDirectories: false,
+        description: 'Claude Code agents'
+      }
+    ]
+  },
+
+  // ============================================
+  // ONA - Cloud-based, no local skills
+  // ============================================
+  'ona': {
+    tabs: []
+  },
+
+  // ============================================
+  // AGENTMAN - No confirmed skills path
+  // ============================================
+  'agentman': {
+    tabs: []
+  },
+
+  // ============================================
+  // MUX - No confirmed skills path
+  // ============================================
+  'mux': {
+    tabs: []
+  },
+
+  // ============================================
+  // SPRING AI - Library, not standalone client
+  // ============================================
+  'spring-ai': {
+    tabs: []
+  },
+
+  // ============================================
+  // DATABRICKS - Workspace-level skills only
+  // ============================================
+  'databricks': {
+    tabs: []
+  }
+};
+
+/**
+ * Get skill tabs for a specific client
+ */
+export function getClientSkillTabs(clientId) {
+  const config = CLIENT_SKILLS[clientId];
+  return config ? config.tabs : [];
+}
+
+/**
+ * Check if a client has any skill/prompt support
+ */
+export function clientHasSkills(clientId) {
+  const tabs = getClientSkillTabs(clientId);
+  return tabs && tabs.length > 0;
+}
+
+/**
+ * Get a specific tab configuration for a client
+ */
+export function getClientSkillTab(clientId, tabId) {
+  const tabs = getClientSkillTabs(clientId);
+  return tabs.find(t => t.id === tabId);
+}
+
+/**
+ * Get all clients that support skills
+ */
+export function getClientsWithSkillSupport() {
+  return Object.entries(CLIENT_SKILLS)
+    .filter(([_, config]) => config.tabs && config.tabs.length > 0)
+    .map(([clientId, config]) => ({
+      clientId,
+      tabs: config.tabs
+    }));
+}
+
+// Legacy exports for backwards compatibility
+export const SKILL_SCOPES = {};
+export const COMMANDS_PATH = path.join(homedir, '.claude', 'commands');
+
+export function getScope(scopeId) {
+  return null;
+}
+
+export function getScopesByPriority() {
+  return [];
+}
+
+export function getScopePath(scopeId) {
+  return null;
+}
+
+export function isScopeReadOnly(scopeId) {
+  return true;
+}