roles.ts

import { ROLE_IDS, type RoleId } from './roleIds';

/**
 * GitHub team configuration
 */
export interface GitHubConfig {
  /** Team name (usually matches role ID) */
  team: string;
  /** Parent team role ID */
  parent?: RoleId;
}

/**
 * Discord role configuration
 */
export interface DiscordConfig {
  /** Display name in Discord (can have spaces) */
  role: string;
}

/**
 * Google Workspace group configuration
 */
export interface GoogleConfig {
  /** Group name (used as prefix for @modelcontextprotocol.io email) */
  group: string;
  /** If true, accepts emails from anyone including external users */
  isEmailGroup?: boolean;
  /** If true, members of this role get a Google Workspace user account */
  provisionUser?: boolean;
}

/**
 * Role definition with platform-specific configurations.
 * A role only exists on platforms where it has a config key.
 */
export interface Role {
  id: RoleId;
  description: string;
  github?: GitHubConfig;
  discord?: DiscordConfig;
  google?: GoogleConfig;
  /**
   * Roles that are implied for Discord membership.
   * If a user has this role, they automatically get the implied roles' Discord roles too.
   * This is separate from GitHub parent relationships and allows Discord-specific hierarchy.
   */
  discordImplies?: readonly RoleId[];
}

/**
 * All roles in the MCP organization.
 * Each role specifies which platforms it exists on via presence of config keys.
 */
export const ROLES: readonly Role[] = [
  // ===================
  // Organization Structure
  // ===================
  {
    id: ROLE_IDS.STEERING_COMMITTEE,
    description: 'MCP Steering Committee',
    github: { team: 'steering-committee' },
    // No discord - this is a GitHub-only organizational container
  },
  {
    id: ROLE_IDS.ADMINISTRATORS,
    description: 'Discord server administrators',
    discord: { role: 'administrators (synced)' },
    // Discord only - no GitHub equivalent
  },
  {
    id: ROLE_IDS.COMMUNITY_MANAGERS,
    description: 'Discord community managers',
    discord: { role: 'community managers (synced)' },
    // Discord only - no GitHub equivalent
  },
  {
    id: ROLE_IDS.LEAD_MAINTAINERS,
    description: 'Lead core maintainers',
    github: { team: 'lead-maintainers', parent: ROLE_IDS.STEERING_COMMITTEE },
    discord: { role: 'lead maintainers (synced)' },
    google: { group: 'lead-maintainers', provisionUser: true },
  },
  {
    id: ROLE_IDS.CORE_MAINTAINERS,
    description: 'Core maintainers',
    github: { team: 'core-maintainers', parent: ROLE_IDS.STEERING_COMMITTEE },
    discord: { role: 'core maintainers (synced)' },
    google: { group: 'core-maintainers', provisionUser: true },
  },
  {
    id: ROLE_IDS.MODERATORS,
    description: 'Community moderators',
    github: { team: 'moderators', parent: ROLE_IDS.STEERING_COMMITTEE },
    discord: { role: 'community moderators (synced)' },
  },

  // ===================
  // Maintainer Groups
  // ===================
  {
    id: ROLE_IDS.MAINTAINERS,
    description: 'General maintainers',
    discord: { role: 'maintainers (synced)' },
    // GWS user accounts are opt-in: maintainers add firstName/lastName/googleEmailPrefix
    // to their entry in users.ts via PR to get an @modelcontextprotocol.io account
    google: { group: 'maintainers', provisionUser: true },
  },
  {
    id: ROLE_IDS.DOCS_MAINTAINERS,
    description: 'MCP docs maintainers',
    github: { team: 'docs-maintainers', parent: ROLE_IDS.STEERING_COMMITTEE },
    // No discord role for docs maintainers
  },
  {
    id: ROLE_IDS.INSPECTOR_MAINTAINERS,
    description: 'MCP Inspector maintainers',
    github: { team: 'inspector-maintainers', parent: ROLE_IDS.STEERING_COMMITTEE },
    discord: { role: 'inspector maintainers (synced)' },
  },
  {
    id: ROLE_IDS.MCPB_MAINTAINERS,
    description: 'MCPB (Model Context Protocol Bundle) maintainers',
    github: { team: 'mcpb-maintainers', parent: ROLE_IDS.STEERING_COMMITTEE },
    // No discord role
  },
  {
    id: ROLE_IDS.REFERENCE_SERVERS_MAINTAINERS,
    description: 'Reference servers maintainers',
    discord: { role: 'reference servers maintainers (synced)' },
    // Discord only for now
  },
  {
    id: ROLE_IDS.REGISTRY_MAINTAINERS,
    description: 'Official registry builders and maintainers',
    github: { team: 'registry-wg', parent: ROLE_IDS.WORKING_GROUPS },
    discord: { role: 'registry maintainers (synced)' },
    google: { group: 'registry-wg', provisionUser: true },
  },
  {
    id: ROLE_IDS.USE_MCP_MAINTAINERS,
    description: 'use-mcp maintainers',
    discord: { role: 'use-mcp maintainers (synced)' },
    // Discord only
  },

  // ===================
  // SDK Maintainers
  // ===================
  {
    id: ROLE_IDS.SDK_MAINTAINERS,
    description: 'Authors and maintainers of official MCP SDKs',
    github: { team: 'sdk-maintainers', parent: ROLE_IDS.STEERING_COMMITTEE },
    discord: { role: 'sdk maintainers (synced)' },
    discordImplies: [ROLE_IDS.MAINTAINERS], // SDK maintainers are also general maintainers
  },
  {
    id: ROLE_IDS.CSHARP_SDK,
    description: 'Official C# SDK maintainers',
    github: { team: 'csharp-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'c# sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.CSHARP_SDK_ADMIN,
    description: 'C# SDK repository admins',
    github: { team: 'csharp-sdk-admin', parent: ROLE_IDS.CSHARP_SDK },
    // GitHub only - for repo admin access
  },
  {
    id: ROLE_IDS.GO_SDK,
    description: 'The Go SDK Team',
    github: { team: 'go-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'go sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.JAVA_SDK,
    description: 'Official Java SDK maintainers',
    github: { team: 'java-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'java sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.KOTLIN_SDK,
    description: 'Official Kotlin SDK maintainers',
    github: { team: 'kotlin-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'kotlin sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.MCP_APPS_SDK,
    description: 'Official MCP Apps SDK maintainers',
    github: { team: 'mcp-apps-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    // No Discord channel/role yet: #mcp-apps-sdk-dev in the future
  },
  {
    id: ROLE_IDS.PHP_SDK,
    description: 'Official PHP SDK maintainers',
    github: { team: 'php-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'php sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.PYTHON_SDK,
    description: 'Official Python SDK maintainers',
    github: { team: 'python-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'python sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.PYTHON_SDK_AUTH,
    description: 'Python SDK auth code owners',
    github: { team: 'python-sdk-auth', parent: ROLE_IDS.PYTHON_SDK },
    // GitHub only - for CODEOWNERS
  },
  {
    id: ROLE_IDS.RUBY_SDK,
    description: 'Official Ruby SDK maintainers',
    github: { team: 'ruby-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'ruby sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.RUST_SDK,
    description: 'Official Rust SDK maintainers',
    github: { team: 'rust-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'rust sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.SWIFT_SDK,
    description: 'Official Swift SDK maintainers',
    github: { team: 'swift-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'swift sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.TYPESCRIPT_SDK,
    description: 'Official TypeScript SDK',
    github: { team: 'typescript-sdk', parent: ROLE_IDS.SDK_MAINTAINERS },
    discord: { role: 'typescript sdk maintainers (synced)' },
  },
  {
    id: ROLE_IDS.TYPESCRIPT_SDK_AUTH,
    description: 'Code owners for auth in Typescript SDK',
    github: { team: 'typescript-sdk-auth', parent: ROLE_IDS.TYPESCRIPT_SDK },
    // GitHub only - for CODEOWNERS
  },
  {
    id: ROLE_IDS.TYPESCRIPT_SDK_COLLABORATORS,
    description: 'TypeScript SDK collaborators',
    github: { team: 'typescript-sdk-collaborators', parent: ROLE_IDS.TYPESCRIPT_SDK },
    // GitHub only
  },

  // ===================
  // Working Groups
  // ===================
  {
    id: ROLE_IDS.WORKING_GROUPS,
    description: 'MCP Working Groups',
    github: { team: 'working-groups', parent: ROLE_IDS.STEERING_COMMITTEE },
    // No discord - organizational container
  },
  {
    id: ROLE_IDS.AUTH_MAINTAINERS,
    description: 'Auth Maintainers',
    github: { team: 'auth-maintainers', parent: ROLE_IDS.WORKING_GROUPS },
    // See AUTH_IG for Discord role
  },
  {
    id: ROLE_IDS.SECURITY_WG,
    description: 'Security Working Group',
    github: { team: 'security-wg', parent: ROLE_IDS.WORKING_GROUPS },
    // See interest group for Discord role
  },
  {
    id: ROLE_IDS.SERVER_IDENTITY_WG,
    description: 'Server Identity Working Group',
    discord: { role: 'server identity working group (synced)' },
    // Discord only for now
  },
  {
    id: ROLE_IDS.TRANSPORT_WG,
    description: 'Transport Working Group',
    github: { team: 'transport-wg', parent: ROLE_IDS.WORKING_GROUPS },
    discord: { role: 'transports working group (synced)' },
  },
  {
    id: ROLE_IDS.MCP_APPS_WG,
    description: 'MCP Apps Working Group',
    github: { team: 'mcp-apps-wg', parent: ROLE_IDS.WORKING_GROUPS },
    discord: { role: 'mcp apps working group (synced)' },
  },

  // ===================
  // Interest Groups
  // ===================
  {
    id: ROLE_IDS.INTEREST_GROUPS,
    description: 'Interest Groups',
    github: { team: 'interest-groups', parent: ROLE_IDS.STEERING_COMMITTEE },
    // No discord - organizational container
  },
  {
    id: ROLE_IDS.AGENTS_IG,
    description: 'Agents Interest Group',
    discord: { role: 'agents interest group (synced)' },
    // Discord only
  },
  {
    id: ROLE_IDS.AUTH_IG,
    description: 'Auth Interest Group',
    discord: { role: 'auth interest group (synced)' },
    // Discord only - separate from AUTH_MAINTAINERS which is GitHub
  },
  {
    id: ROLE_IDS.CLIENT_IMPLEMENTOR_IG,
    description: 'Client Implementor Interest Group',
    discord: { role: 'client implementor interest group (synced)' },
    // Discord only
  },
  {
    id: ROLE_IDS.FINANCIAL_SERVICES_IG,
    description: 'Financial Services Interest Group',
    github: { team: 'ig-financial-services', parent: ROLE_IDS.INTEREST_GROUPS },
    discord: { role: 'financial services interest group (synced)' },
  },
  {
    id: ROLE_IDS.GATEWAYS_IG,
    description: 'Gateways Interest Group',
    // No GitHub role yet
    discord: { role: 'gateways interest group (synced)' },
  },
  {
    id: ROLE_IDS.PRIMITIVE_GROUPING_IG,
    description: 'Primitive Grouping Interest Group',
    github: { team: 'primitive-grouping-ig', parent: ROLE_IDS.INTEREST_GROUPS },
    discord: { role: 'primitive grouping interest group (synced)' },
  },
  {
    id: ROLE_IDS.SKILLS_OVER_MCP_IG,
    description: 'Skills Over MCP Interest Group',
    github: { team: 'skills-over-mcp-ig', parent: ROLE_IDS.INTEREST_GROUPS },
    discord: { role: 'skills over mcp interest group (synced)' },
  },
  {
    id: ROLE_IDS.TOOL_ANNOTATIONS_IG,
    description: 'Tool Annotations Interest Group',
    github: { team: 'tool-annotations-ig', parent: ROLE_IDS.INTEREST_GROUPS },
    discord: { role: 'tool annotations interest group (synced)' },
  },

  // ===================
  // WG/IG Facilitators (Discord only)
  // ===================
  {
    id: ROLE_IDS.WG_IG_FACILITATORS,
    description: 'Working Group and Interest Group facilitators with calendar access',
    discord: { role: 'wg/ig facilitators (synced)' },
    // Discord only - grants meet.modelcontextprotocol.io calendar access
  },

  // ===================
  // Email Groups (Google only)
  // ===================
  {
    id: ROLE_IDS.ANTITRUST,
    description: 'Antitrust compliance contacts',
    google: { group: 'antitrust', isEmailGroup: true },
    // Google only
  },
  {
    id: ROLE_IDS.CATCH_ALL,
    description: 'Catch-all email group',
    google: { group: 'catch-all', isEmailGroup: true },
    // Google only
  },
] as const;

/**
 * Get a role by ID
 */
export function getRole(id: RoleId): Role | undefined {
  return ROLES.find((r) => r.id === id);
}

/**
 * Get all roles that exist on a specific platform
 */
export function getRolesForPlatform(platform: 'github' | 'discord' | 'google'): Role[] {
  return ROLES.filter((r) => r[platform] !== undefined);
}

/**
 * Build a lookup map of roles by ID
 */
export function buildRoleLookup(): Map<RoleId, Role> {
  return new Map(ROLES.map((r) => [r.id, r]));
}