claude-code-best/src/commands/plugin/PluginErrors.tsx

import { getPluginErrorMessage, type PluginError } from '../../types/plugin.js'

export function formatErrorMessage(error: PluginError): string {
  switch (error.type) {
    case 'path-not-found':
      return `${error.component} path not found: ${error.path}`
    case 'git-auth-failed':
      return `Git ${error.authType.toUpperCase()} authentication failed for ${error.gitUrl}`
    case 'git-timeout':
      return `Git ${error.operation} timed out for ${error.gitUrl}`
    case 'network-error':
      return `Network error accessing ${error.url}${error.details ? `: ${error.details}` : ''}`
    case 'manifest-parse-error':
      return `Failed to parse manifest at ${error.manifestPath}: ${error.parseError}`
    case 'manifest-validation-error':
      return `Invalid manifest at ${error.manifestPath}: ${error.validationErrors.join(', ')}`
    case 'plugin-not-found':
      return `Plugin "${error.pluginId}" not found in marketplace "${error.marketplace}"`
    case 'marketplace-not-found':
      return `Marketplace "${error.marketplace}" not found`
    case 'marketplace-load-failed':
      return `Failed to load marketplace "${error.marketplace}": ${error.reason}`
    case 'mcp-config-invalid':
      return `Invalid MCP server config for "${error.serverName}": ${error.validationError}`
    case 'mcp-server-suppressed-duplicate': {
      const dup = error.duplicateOf.startsWith('plugin:')
        ? `server provided by plugin "${error.duplicateOf.split(':')[1] ?? '?'}"`
        : `already-configured "${error.duplicateOf}"`
      return `MCP server "${error.serverName}" skipped — same command/URL as ${dup}`
    }
    case 'hook-load-failed':
      return `Failed to load hooks from ${error.hookPath}: ${error.reason}`
    case 'component-load-failed':
      return `Failed to load ${error.component} from ${error.path}: ${error.reason}`
    case 'mcpb-download-failed':
      return `Failed to download MCPB from ${error.url}: ${error.reason}`
    case 'mcpb-extract-failed':
      return `Failed to extract MCPB ${error.mcpbPath}: ${error.reason}`
    case 'mcpb-invalid-manifest':
      return `MCPB manifest invalid at ${error.mcpbPath}: ${error.validationError}`
    case 'marketplace-blocked-by-policy':
      return error.blockedByBlocklist
        ? `Marketplace "${error.marketplace}" is blocked by enterprise policy`
        : `Marketplace "${error.marketplace}" is not in the allowed marketplace list`
    case 'dependency-unsatisfied':
      return error.reason === 'not-enabled'
        ? `Dependency "${error.dependency}" is disabled`
        : `Dependency "${error.dependency}" is not installed`
    case 'lsp-config-invalid':
      return `Invalid LSP server config for "${error.serverName}": ${error.validationError}`
    case 'lsp-server-start-failed':
      return `LSP server "${error.serverName}" failed to start: ${error.reason}`
    case 'lsp-server-crashed':
      return error.signal
        ? `LSP server "${error.serverName}" crashed with signal ${error.signal}`
        : `LSP server "${error.serverName}" crashed with exit code ${error.exitCode ?? 'unknown'}`
    case 'lsp-request-timeout':
      return `LSP server "${error.serverName}" timed out on ${error.method} after ${error.timeoutMs}ms`
    case 'lsp-request-failed':
      return `LSP server "${error.serverName}" ${error.method} failed: ${error.error}`
    case 'plugin-cache-miss':
      return `Plugin "${error.plugin}" not cached at ${error.installPath}`
    case 'generic-error':
      return error.error
  }
  const _exhaustive: never = error
  return getPluginErrorMessage(_exhaustive)
}

export function getErrorGuidance(error: PluginError): string | null {
  switch (error.type) {
    case 'path-not-found':
      return 'Check that the path in your manifest or marketplace config is correct'
    case 'git-auth-failed':
      return error.authType === 'ssh'
        ? 'Configure SSH keys or use HTTPS URL instead'
        : 'Configure credentials or use SSH URL instead'
    case 'git-timeout':
    case 'network-error':
      return 'Check your internet connection and try again'
    case 'manifest-parse-error':
      return 'Check manifest file syntax in the plugin directory'
    case 'manifest-validation-error':
      return 'Check manifest file follows the required schema'
    case 'plugin-not-found':
      return `Plugin may not exist in marketplace "${error.marketplace}"`
    case 'marketplace-not-found':
      return error.availableMarketplaces.length > 0
        ? `Available marketplaces: ${error.availableMarketplaces.join(', ')}`
        : 'Add the marketplace first using /plugin marketplace add'
    case 'mcp-config-invalid':
      return 'Check MCP server configuration in .mcp.json or manifest'
    case 'mcp-server-suppressed-duplicate': {
      // duplicateOf is "plugin:name:srv" when another plugin won dedup —
      // users can't remove plugin-provided servers from their MCP config,
      // so point them at the winning plugin instead.
      if (error.duplicateOf.startsWith('plugin:')) {
        const winningPlugin =
          error.duplicateOf.split(':')[1] ?? 'the other plugin'
        return `Disable plugin "${winningPlugin}" if you want this plugin's version instead`
      }
      return `Remove "${error.duplicateOf}" from your MCP config if you want the plugin's version instead`
    }
    case 'hook-load-failed':
      return 'Check hooks.json file syntax and structure'
    case 'component-load-failed':
      return `Check ${error.component} directory structure and file permissions`
    case 'mcpb-download-failed':
      return 'Check your internet connection and URL accessibility'
    case 'mcpb-extract-failed':
      return 'Verify the MCPB file is valid and not corrupted'
    case 'mcpb-invalid-manifest':
      return 'Contact the plugin author about the invalid manifest'
    case 'marketplace-blocked-by-policy':
      if (error.blockedByBlocklist) {
        return 'This marketplace source is explicitly blocked by your administrator'
      }
      return error.allowedSources.length > 0
        ? `Allowed sources: ${error.allowedSources.join(', ')}`
        : 'Contact your administrator to configure allowed marketplace sources'
    case 'dependency-unsatisfied':
      return error.reason === 'not-enabled'
        ? `Enable "${error.dependency}" or uninstall "${error.plugin}"`
        : `Install "${error.dependency}" or uninstall "${error.plugin}"`
    case 'lsp-config-invalid':
      return 'Check LSP server configuration in the plugin manifest'
    case 'lsp-server-start-failed':
    case 'lsp-server-crashed':
    case 'lsp-request-timeout':
    case 'lsp-request-failed':
      return 'Check LSP server logs with --debug for details'
    case 'plugin-cache-miss':
      return 'Run /plugins to refresh the plugin cache'
    case 'marketplace-load-failed':
    case 'generic-error':
      return null
  }
  const _exhaustive: never = error
  return null
}