Automatic Thread Creation (#53)

* feat(auto-threads): Add auto-thread creation and config schema

Automatically create threads from messages in configured channels. Adds a call to MessageCreate._handleAutoThreads and implements the handler to lookup per-channel auto-thread config, skip users with excluded roles, and start a thread with a templated name (supports $USERNAME, $SURFACE_NAME, $USER_ID). Updates the guild config schema with autoThreadSchema and registers auto_threads in rawGuildConfigSchema (includes channel_id, name with placeholders, and exclude_roles). Thread creation errors are caught to avoid unhandled rejections.

* fix(eslint): Resolve trailing comma eslint error

* style(config-schema): Use spaces for indentation

* feat(config-schema): Replace role exclusion with full role scoping in auto-threads

* feat(auto-thread-creation): Add full role scoping logic to auto-threads

* fix(eslint): Resolve unnecessary nullish coalescing use eslint error

* docs(auto-threads): Add auto-thread creation feature

Author: SplderMat

README.md

@@ -23,6 +23,7 @@ A Discord moderation and utility bot built with [Bun](https://bun.sh), [discord.
 - **Moderation Activity** — View staff moderation stats (infractions dealt, requests reviewed/made), filterable by month and year.
 - **Auto-Publish** — Automatically crosspost messages in announcement channels.
 - **Auto-Reactions** — Add configured reactions to messages in specified channels.
+- **Auto-Threads** — Automatically start threads on messages in specified channels.
 - **Media Channels** — Enforce attachment requirements in specified channels.
 - **Scheduled Messages** — Cron-based scheduled messages with Sentry monitor slugs.
 - **Role Requests** — Configurable role request channels with optional TTL.

docs/configuration.md

@@ -124,6 +124,20 @@ auto_reactions:
     exclude_patterns: ["regex"]         # Optional
 ```
 
+### Auto-Threads
+
+```yaml
+auto_threads:
+  - channel_id: "<channel_id>"
+    # $USERNAME = user's username
+    # $SURFACE_NAME = user's username and surface name, if any
+    # $USER_ID = user's ID
+    name: "$SURFACE_NAME's thread"
+    role_scoping:
+      include_roles: ["<role_id>"]
+      exclude_roles: ["<role_id>"]
+```
+
 ### Media Channels
 
 ```yaml

src/events/MessageCreate.ts

@@ -61,6 +61,7 @@ export default class MessageCreate extends EventListener {
 
 		MessageCache.cache(message);
 		MessageCreate._handleAutoReactions(message, config);
+		MessageCreate._handleAutoThreads(message, config);
 		await MessageCreate._handleMediaChannel(message, config);
 
 		// Handle media conversion
@@ -235,6 +236,25 @@ export default class MessageCreate extends EventListener {
 		}
 	}
 
+	private static _handleAutoThreads(message: Message<true>, config: GuildConfig): void {
+		const autoThreadChannel = config.data.auto_threads
+			.find(autoThreadChannel => autoThreadChannel.channel_id === message.channel.id);
+
+		if (!autoThreadChannel || !message.member) return;
+
+		const inScope = config.roleInScope(message.member, autoThreadChannel.role_scoping);
+
+		if (!inScope) return;
+
+		message.startThread({
+			name: autoThreadChannel.name
+				.replace("$USERNAME", `@${message.author.username}`)
+				.replace("$SURFACE_NAME", getSurfaceName(message.member))
+				.replace("$USER_ID", message.author.id),
+			reason: `Auto-thread created from @${message.author.username} (${message.author.id})'s message with ID ${message.id} in #${message.channel.name}`
+		}).catch(() => null);
+	}
+
 	private static async _handleMediaConversion(message: Message<true>, config: GuildConfig): Promise<void> {
 		if (!message.attachments.size || message.content) return;
 

src/managers/config/schema.ts

@@ -299,6 +299,22 @@ const autoReactionSchema = z.object({
 	exclude_patterns: z.array(stringSchema).default([])
 });
 
+const autoThreadSchema = z.object({
+	// The channel to listen for messages in
+	channel_id: snowflakeSchema,
+	/**
+     * The name of the thread to create
+     *
+     * ## Args
+     *
+     * - `$USERNAME`: The username of the message author
+     * - `$SURFACE_NAME`: The username and, if available, visible name of the message author on the current surface (e.g., their nickname in that guild)
+     * - `$USER_ID`: The ID of the message author
+     */
+	name: placeholderString(["USERNAME", "SURFACE_NAME", "USER_ID"], 1, 100).default("$SURFACE_NAME's thread"),
+	role_scoping: roleScopingSchema.default({})
+});
+
 const reportSchema = z.object({
 	// Channel to send reports to
 	channel_id: snowflakeSchema,
@@ -546,6 +562,7 @@ export const rawGuildConfigSchema = z.object({
 	// Automatically publish announcement messages in these channels
 	auto_publish_announcements: z.array(snowflakeSchema).default([]),
 	auto_reactions: z.array(autoReactionSchema).default([]),
+	auto_threads: z.array(autoThreadSchema).default([]),
 	// Toggle the `SendMessages` permission in a channel depending on whether a stage event is active
 	stage_event_overrides: z.array(stageEventOverrideSchema).default([]),
 	notification_channel_id: snowflakeSchema.optional(),