discord-ops 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# discord-ops
+
+## 0.1.0
+
+### Features
+
+- 18 MCP tools: messaging, channels, guilds, members, roles, threads, health check
+- Multi-guild project routing with channel aliases and notification types
+- Per-project `.discord-ops.json` config overrides
+- Lazy Discord login (tools enumerate before connection)
+- Zod input validation on all tools
+- Error sanitization (tokens, webhooks, snowflakes stripped)
+- Audit logging to stderr
+- Fuzzy name resolution (exact, normalized, substring)
+- Stdio transport
+- Full OSS scaffolding (MIT, CI/CD, changesets, dependabot)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Booked Solid Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# discord-ops
+
+Agency-grade Discord MCP server with multi-guild project routing.
+
+[![CI](https://github.com/bookedsolidtech/discord-ops/actions/workflows/ci.yml/badge.svg)](https://github.com/bookedsolidtech/discord-ops/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/discord-ops)](https://www.npmjs.com/package/discord-ops)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Features
+
+- **18 MCP tools** — messaging, channels, guilds, members, roles, threads, health check
+- **Multi-guild project routing** — `send_message({ project: "my-app", channel: "builds" })` instead of raw channel IDs
+- **Notification routing** — map notification types (ci_build, deploy, error) to channels per project
+- **Lazy login** — tools enumerate before Discord connects; first tool call triggers login
+- **Zod validation** — all inputs validated before execution
+- **Error sanitization** — tokens, webhook URLs, and snowflake IDs stripped from error output
+- **Audit logging** — every tool call logged to stderr
+- **Fuzzy name resolution** — find channels/roles/members by name, normalized name, or substring
+
+## Quick Start
+
+```bash
+# Install
+npm install -g discord-ops
+
+# Set your bot token
+export DISCORD_TOKEN="your-bot-token"
+
+# Run health check
+discord-ops health
+
+# Start MCP server (stdio)
+discord-ops
+```
+
+## Claude Code Integration
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "discord": {
+      "command": "npx",
+      "args": ["-y", "discord-ops"],
+      "env": {
+        "DISCORD_TOKEN": "your-bot-token"
+      }
+    }
+  }
+}
+```
+
+## Project Routing
+
+The killer feature: route messages by project name and channel alias instead of raw IDs.
+
+### Global config (`~/.discord-ops.json`)
+
+```json
+{
+  "projects": {
+    "my-app": {
+      "guild_id": "123456789012345678",
+      "channels": {
+        "dev": "CHANNEL_ID",
+        "builds": "CHANNEL_ID",
+        "alerts": "CHANNEL_ID"
+      },
+      "default_channel": "dev"
+    }
+  },
+  "default_project": "my-app",
+  "notification_routing": {
+    "ci_build": "builds",
+    "error": "alerts",
+    "dev": "dev"
+  }
+}
+```
+
+### Per-project config (`.discord-ops.json` in repo root)
+
+```json
+{
+  "project": "my-app",
+  "notification_routing": {
+    "ci_build": "builds",
+    "deploy": "builds"
+  }
+}
+```
+
+### Usage
+
+```
+# By project + channel alias
+send_message({ project: "my-app", channel: "builds", content: "Build passed!" })
+
+# By notification type (auto-routed)
+send_message({ notification_type: "ci_build", content: "CI green" })
+
+# Direct channel ID (always works)
+send_message({ channel_id: "123456789", content: "Hello" })
+```
+
+## Tools (v0.1.0)
+
+| Tool | Description |
+|------|-------------|
+| `send_message` | Send a message with project routing |
+| `get_messages` | Fetch recent messages |
+| `edit_message` | Edit a bot message |
+| `delete_message` | Delete a message |
+| `add_reaction` | React to a message |
+| `list_channels` | List guild channels |
+| `get_channel` | Get channel details |
+| `create_channel` | Create a channel |
+| `edit_channel` | Edit channel properties |
+| `delete_channel` | Delete a channel |
+| `list_guilds` | List bot's guilds |
+| `get_guild` | Get guild details |
+| `list_members` | List guild members |
+| `get_member` | Get member details |
+| `list_roles` | List guild roles |
+| `create_thread` | Create a thread |
+| `list_threads` | List active threads |
+| `health_check` | Bot status + permissions |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `DISCORD_TOKEN` | Yes | Discord bot token |
+| `DISCORD_OPS_CONFIG` | No | Path to global config (default: `~/.discord-ops.json`) |
+| `DISCORD_OPS_LOG_LEVEL` | No | `debug`, `info`, `warn`, `error` (default: `info`) |
+
+## Development
+
+```bash
+git clone https://github.com/bookedsolidtech/discord-ops.git
+cd discord-ops
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/cli/health.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/cli/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/cli/health.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC"}

package/dist/cli/health.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health.js.map

package/dist/cli/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/cli/health.ts"],"names":[],"mappings":""}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { loadConfig } from "../config/index.js";
+import { DiscordClient } from "../client.js";
+import { createServer } from "../server.js";
+import { startStdioTransport } from "../transport/stdio.js";
+import { logger, setLogLevel } from "../utils/logger.js";
+async function main() {
+    const args = process.argv.slice(2);
+    // Handle --help
+    if (args.includes("--help") || args.includes("-h")) {
+        printUsage();
+        process.exit(0);
+    }
+    // Handle --version
+    if (args.includes("--version") || args.includes("-v")) {
+        console.log("discord-ops 0.1.0");
+        process.exit(0);
+    }
+    // Handle health subcommand
+    if (args[0] === "health") {
+        await runHealthCheck();
+        return;
+    }
+    // Configure log level
+    const logLevel = process.env.DISCORD_OPS_LOG_LEVEL;
+    if (logLevel)
+        setLogLevel(logLevel);
+    // Load config (does NOT require Discord connection)
+    const config = loadConfig();
+    // Create lazy Discord client
+    const discord = new DiscordClient(config.token);
+    // Create MCP server with tool context
+    const server = createServer({ discord, config });
+    // Start stdio transport
+    await startStdioTransport(server);
+    // Graceful shutdown
+    const shutdown = async () => {
+        logger.info("Shutting down...");
+        await discord.destroy();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+async function runHealthCheck() {
+    try {
+        const config = loadConfig();
+        const discord = new DiscordClient(config.token);
+        console.log("Connecting to Discord...");
+        const client = await discord.getClient();
+        console.log(`\nBot: ${client.user?.tag}`);
+        console.log(`Guilds: ${client.guilds.cache.size}`);
+        for (const [id, guild] of client.guilds.cache) {
+            const me = await guild.members.fetchMe();
+            console.log(`\n  ${guild.name} (${id})`);
+            console.log(`    Members: ${guild.memberCount}`);
+            console.log(`    Permissions: ${me.permissions.toArray().join(", ")}`);
+        }
+        console.log(`\nProjects configured: ${Object.keys(config.global.projects).length}`);
+        for (const [name, project] of Object.entries(config.global.projects)) {
+            console.log(`  ${name}: guild=${project.guild_id}, channels=${Object.keys(project.channels).join(", ")}`);
+        }
+        console.log("\nHealth check passed.");
+        await discord.destroy();
+    }
+    catch (err) {
+        console.error("Health check failed:", err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+}
+function printUsage() {
+    console.log(`
+discord-ops - Agency-grade Discord MCP server
+
+USAGE:
+  discord-ops              Start MCP server (stdio transport)
+  discord-ops health       Run health check + permission audit
+  discord-ops --help       Show this help
+  discord-ops --version    Show version
+
+ENVIRONMENT:
+  DISCORD_TOKEN            Discord bot token (required)
+  DISCORD_OPS_CONFIG       Path to global config file (default: ~/.discord-ops.json)
+  DISCORD_OPS_LOG_LEVEL    Log level: debug, info, warn, error (default: info)
+
+CONFIG FILES:
+  ~/.discord-ops.json      Global project routing config
+  .discord-ops.json        Per-project overrides (in repo root)
+
+DOCUMENTATION:
+  https://github.com/bookedsolidtech/discord-ops
+`);
+}
+main().catch((err) => {
+    logger.error("Fatal error", { error: err instanceof Error ? err.message : String(err) });
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,22 @@
+import { Client, type Guild, type TextChannel } from "discord.js";
+/**
+ * Lazy Discord client — tools enumerate before Discord connects.
+ * First tool call triggers login + cache warmup.
+ */
+export declare class DiscordClient {
+    private client;
+    private token;
+    private connecting;
+    private guildCache;
+    constructor(token: string);
+    /**
+     * Returns the underlying discord.js Client, connecting lazily on first call.
+     */
+    getClient(): Promise<Client>;
+    private connect;
+    getGuild(guildId: string): Promise<Guild>;
+    getChannel(channelId: string): Promise<TextChannel>;
+    destroy(): Promise<void>;
+    get isConnected(): boolean;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAKrF;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,UAAU,CAA4B;gBAElC,KAAK,EAAE,MAAM;IAQzB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;YASpB,OAAO;IAgCf,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAUzC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}

package/dist/client.js

@@ -0,0 +1,87 @@
+import { Client, GatewayIntentBits } from "discord.js";
+import { logger } from "./utils/logger.js";
+import { validateTokenFormat } from "./security/token-validator.js";
+import { TTLCache } from "./utils/cache.js";
+/**
+ * Lazy Discord client — tools enumerate before Discord connects.
+ * First tool call triggers login + cache warmup.
+ */
+export class DiscordClient {
+    client = null;
+    token;
+    connecting = null;
+    guildCache = new TTLCache(300);
+    constructor(token) {
+        const validation = validateTokenFormat(token);
+        if (!validation.valid) {
+            throw new Error(`Invalid Discord token: ${validation.reason}`);
+        }
+        this.token = token;
+    }
+    /**
+     * Returns the underlying discord.js Client, connecting lazily on first call.
+     */
+    async getClient() {
+        if (this.client?.isReady())
+            return this.client;
+        if (this.connecting)
+            return this.connecting;
+        this.connecting = this.connect();
+        return this.connecting;
+    }
+    async connect() {
+        logger.info("Connecting to Discord...");
+        const client = new Client({
+            intents: [
+                GatewayIntentBits.Guilds,
+                GatewayIntentBits.GuildMessages,
+                GatewayIntentBits.GuildMembers,
+                GatewayIntentBits.MessageContent,
+            ],
+        });
+        await client.login(this.token);
+        await new Promise((resolve) => {
+            if (client.isReady()) {
+                resolve();
+            }
+            else {
+                client.once("ready", () => resolve());
+            }
+        });
+        logger.info("Discord connected", {
+            user: client.user?.tag,
+            guilds: client.guilds.cache.size,
+        });
+        this.client = client;
+        this.connecting = null;
+        return client;
+    }
+    async getGuild(guildId) {
+        const cached = this.guildCache.get(guildId);
+        if (cached)
+            return cached;
+        const client = await this.getClient();
+        const guild = await client.guilds.fetch(guildId);
+        this.guildCache.set(guildId, guild);
+        return guild;
+    }
+    async getChannel(channelId) {
+        const client = await this.getClient();
+        const channel = await client.channels.fetch(channelId);
+        if (!channel || !channel.isTextBased()) {
+            throw new Error(`Channel ${channelId} not found or not a text channel`);
+        }
+        return channel;
+    }
+    async destroy() {
+        if (this.client) {
+            this.client.destroy();
+            this.client = null;
+            logger.info("Discord client destroyed");
+        }
+    }
+    get isConnected() {
+        return this.client?.isReady() ?? false;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,17 @@
+import { type GlobalConfig, type PerProjectConfig } from "./schema.js";
+export interface LoadedConfig {
+    global: GlobalConfig;
+    perProject?: PerProjectConfig;
+    token: string;
+}
+/**
+ * Loads config from environment + files.
+ *
+ * Resolution priority:
+ *  1. Per-project `.discord-ops.json` (cwd)
+ *  2. Global `~/.discord-ops.json` or DISCORD_OPS_CONFIG env var
+ *  3. Direct params always work regardless
+ */
+export declare function loadConfig(): LoadedConfig;
+export { type GlobalConfig, type PerProjectConfig } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAUzC;AA0CD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,58 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, join } from "node:path";
+import { homedir } from "node:os";
+import { logger } from "../utils/logger.js";
+import { GlobalConfigSchema, PerProjectConfigSchema, } from "./schema.js";
+/**
+ * Loads config from environment + files.
+ *
+ * Resolution priority:
+ *  1. Per-project `.discord-ops.json` (cwd)
+ *  2. Global `~/.discord-ops.json` or DISCORD_OPS_CONFIG env var
+ *  3. Direct params always work regardless
+ */
+export function loadConfig() {
+    const token = process.env.DISCORD_TOKEN;
+    if (!token) {
+        throw new Error("DISCORD_TOKEN environment variable is required");
+    }
+    const global = loadGlobalConfig();
+    const perProject = loadPerProjectConfig();
+    return { global, perProject, token };
+}
+function loadGlobalConfig() {
+    const configPath = process.env.DISCORD_OPS_CONFIG ?? resolve(homedir(), ".discord-ops.json");
+    if (!existsSync(configPath)) {
+        logger.debug("No global config found", { path: configPath });
+        return { projects: {} };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+        return GlobalConfigSchema.parse(raw);
+    }
+    catch (err) {
+        logger.warn("Failed to parse global config, using empty config", {
+            path: configPath,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return { projects: {} };
+    }
+}
+function loadPerProjectConfig() {
+    const configPath = join(process.cwd(), ".discord-ops.json");
+    if (!existsSync(configPath)) {
+        return undefined;
+    }
+    try {
+        const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+        return PerProjectConfigSchema.parse(raw);
+    }
+    catch (err) {
+        logger.warn("Failed to parse per-project config", {
+            path: configPath,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GAGvB,MAAM,aAAa,CAAC;AAQrB;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAE1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAE5E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE;YAC/D,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAE5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;YAChD,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/config/profiles.d.ts

@@ -0,0 +1,18 @@
+import type { GlobalConfig, PerProjectConfig } from "./schema.js";
+export interface ResolvedProject {
+    name: string;
+    guildId: string;
+    channels: Record<string, string>;
+    defaultChannel?: string;
+    notificationRouting?: Record<string, string>;
+}
+/**
+ * Resolves a project from global + per-project config.
+ * Per-project notification_routing overrides global.
+ */
+export declare function resolveProject(projectName: string, globalConfig: GlobalConfig, perProjectConfig?: PerProjectConfig): ResolvedProject | undefined;
+/**
+ * Returns the default project name from config.
+ */
+export declare function getDefaultProjectName(globalConfig: GlobalConfig, perProjectConfig?: PerProjectConfig): string | undefined;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/config/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,eAAe,GAAG,SAAS,CAiB7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,MAAM,GAAG,SAAS,CAEpB"}

package/dist/config/profiles.js

@@ -0,0 +1,28 @@
+/**
+ * Resolves a project from global + per-project config.
+ * Per-project notification_routing overrides global.
+ */
+export function resolveProject(projectName, globalConfig, perProjectConfig) {
+    const project = globalConfig.projects[projectName];
+    if (!project)
+        return undefined;
+    // Merge notification routing: per-project overrides global
+    const notificationRouting = {
+        ...globalConfig.notification_routing,
+        ...perProjectConfig?.notification_routing,
+    };
+    return {
+        name: projectName,
+        guildId: project.guild_id,
+        channels: project.channels,
+        defaultChannel: project.default_channel,
+        notificationRouting,
+    };
+}
+/**
+ * Returns the default project name from config.
+ */
+export function getDefaultProjectName(globalConfig, perProjectConfig) {
+    return perProjectConfig?.project ?? globalConfig.default_project;
+}
+//# sourceMappingURL=profiles.js.map

package/dist/config/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,YAA0B,EAC1B,gBAAmC;IAEnC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,2DAA2D;IAC3D,MAAM,mBAAmB,GAAG;QAC1B,GAAG,YAAY,CAAC,oBAAoB;QACpC,GAAG,gBAAgB,EAAE,oBAAoB;KAC1C,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,eAAe;QACvC,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAA0B,EAC1B,gBAAmC;IAEnC,OAAO,gBAAgB,EAAE,OAAO,IAAI,YAAY,CAAC,eAAe,CAAC;AACnE,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export declare const NotificationType: z.ZodEnum<["ci_build", "deploy", "release", "error", "announcement", "dev"]>;
+export type NotificationType = z.infer<typeof NotificationType>;
+export declare const ProjectConfigSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    channels: z.ZodRecord<z.ZodString, z.ZodString>;
+    default_channel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    guild_id: string;
+    channels: Record<string, string>;
+    default_channel?: string | undefined;
+}, {
+    guild_id: string;
+    channels: Record<string, string>;
+    default_channel?: string | undefined;
+}>;
+export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
+export declare const GlobalConfigSchema: z.ZodObject<{
+    projects: z.ZodRecord<z.ZodString, z.ZodObject<{
+        guild_id: z.ZodString;
+        channels: z.ZodRecord<z.ZodString, z.ZodString>;
+        default_channel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        guild_id: string;
+        channels: Record<string, string>;
+        default_channel?: string | undefined;
+    }, {
+        guild_id: string;
+        channels: Record<string, string>;
+        default_channel?: string | undefined;
+    }>>;
+    default_project: z.ZodOptional<z.ZodString>;
+    notification_routing: z.ZodOptional<z.ZodRecord<z.ZodEnum<["ci_build", "deploy", "release", "error", "announcement", "dev"]>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    projects: Record<string, {
+        guild_id: string;
+        channels: Record<string, string>;
+        default_channel?: string | undefined;
+    }>;
+    default_project?: string | undefined;
+    notification_routing?: Partial<Record<"error" | "ci_build" | "deploy" | "release" | "announcement" | "dev", string>> | undefined;
+}, {
+    projects: Record<string, {
+        guild_id: string;
+        channels: Record<string, string>;
+        default_channel?: string | undefined;
+    }>;
+    default_project?: string | undefined;
+    notification_routing?: Partial<Record<"error" | "ci_build" | "deploy" | "release" | "announcement" | "dev", string>> | undefined;
+}>;
+export type GlobalConfig = z.infer<typeof GlobalConfigSchema>;
+export declare const PerProjectConfigSchema: z.ZodObject<{
+    project: z.ZodString;
+    notification_routing: z.ZodOptional<z.ZodRecord<z.ZodEnum<["ci_build", "deploy", "release", "error", "announcement", "dev"]>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    project: string;
+    notification_routing?: Partial<Record<"error" | "ci_build" | "deploy" | "release" | "announcement" | "dev", string>> | undefined;
+}, {
+    project: string;
+    notification_routing?: Partial<Record<"error" | "ci_build" | "deploy" | "release" | "announcement" | "dev", string>> | undefined;
+}>;
+export type PerProjectConfig = z.infer<typeof PerProjectConfigSchema>;
+export declare const EnvConfigSchema: z.ZodObject<{
+    DISCORD_TOKEN: z.ZodString;
+    DISCORD_OPS_CONFIG: z.ZodOptional<z.ZodString>;
+    DISCORD_OPS_LOG_LEVEL: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+}, "strip", z.ZodTypeAny, {
+    DISCORD_TOKEN: string;
+    DISCORD_OPS_LOG_LEVEL?: "debug" | "info" | "warn" | "error" | undefined;
+    DISCORD_OPS_CONFIG?: string | undefined;
+}, {
+    DISCORD_TOKEN: string;
+    DISCORD_OPS_LOG_LEVEL?: "debug" | "info" | "warn" | "error" | undefined;
+    DISCORD_OPS_CONFIG?: string | undefined;
+}>;
+//# sourceMappingURL=schema.d.ts.map