spearkit 0.3.1 → 0.4.0

package/.claude/skills/spearkit/SKILL.md

@@ -62,6 +62,17 @@ await client.start(process.env.DISCORD_TOKEN);              // falls back to DIS
 await client.deployCommands({ guildId: process.env.GUILD_ID }); // omit guildId → global (slow)
 ```
 
+## Pick the right tool
+
+- **Slash command** → `command()`; **typed inputs** → `option.*`; **grouped** → `commandGroup` + `subcommand`; **type-ahead** → `option.string({ autocomplete })`.
+- **Right-click on a user/message** → `userCommand` / `messageCommand`; **`!text` command** → `prefixCommand` (+ typed `args`).
+- **Button** → `button`; **URL button** → `linkButton`; **dropdown** → `stringSelect`; **pick user/role/channel/mentionable** → `userSelect` / `roleSelect` / `channelSelect` / `mentionableSelect`; **form** → `modal` + `textInput`; **carry data** → custom-id `{param}`.
+- **Paged list** → `paginate`; **yes/no gate** → `confirm`.
+- **Reply** → `ctx.reply` / `replyEphemeral`; **>3s work** → `ctx.defer()` then `editReply`; **styled embed** → `ctx.success/error/info/warn`.
+- **Gateway events** → `event(...)`; **rate-limit** → `cooldown`; **role/permission/owner gate** → guards; **cron/interval** → `task` / `client.schedule`; **logs** → `client.logger` + sinks; **usage tracking** → `usage`; **typed env / `.env`** → `env.*`.
+- **Reusable bundle** → `definePlugin` + `client.use`; **file-per-handler** → `client.load`; **deploy** → `client.deployCommands` / `deployAllCommands`.
+- **Primitives** — per-key lock → `KeyedLock`; null-safe fetch → `safeFetch.*`; durations → `formatDuration` / `parseDuration`; timestamps → `discordTimestamp`; cache / rate-limit → `MemoryCache`; config files → `loadConfig`.
+
 ## Recipes
 
 ### Slash command with typed options

package/.claude/skills/spearkit/reference/cheatsheet.md

@@ -4,10 +4,81 @@ Condensed map of every spearkit export. All importable from `"spearkit"` alongsi
 the full discord.js surface. For prose and edge cases, read the package's
 `llms-full.txt` or `docs/`.
 
+## Use cases — reach for
+
+**Bot setup & lifecycle**
+
+| Want to… | Reach for |
+| --- | --- |
+| Start a bot and connect | `new SpearClient({ intents })` + `await client.start(token)` |
+| Choose gateway intents | `Intents.none / default / guilds / messages / all` |
+| Wire up handlers | `client.register(...)`; one file per handler → `client.load(dir)` |
+| Push commands to Discord | `client.deployCommands({ guildId })`; slash + menus, safe CI → `client.deployAllCommands({ strategy: "diff", dryRun })` |
+| Package a reusable feature | `definePlugin(...)` + `client.use(...)` |
+| Migrate an existing discord.js bot | import from `"spearkit"`, swap `Client` → `SpearClient` |
+
+**Commands & input**
+
+| Want to… | Reach for |
+| --- | --- |
+| A slash command | `command({ name, description, run })` |
+| Typed inputs to a command | `options: { x: option.string/integer/number/boolean/user/channel/role/mentionable/attachment(...) }` |
+| Group many commands under one name | `commandGroup` + `subcommand` / `subcommandGroup` |
+| Suggest values while the user types | `option.string({ autocomplete })` |
+| A right-click "Apps" action on a user/message | `userCommand` / `messageCommand` |
+| A classic `!text` command | `prefixCommand(...)` + `new SpearClient({ prefix })` |
+| Parse `!cmd` arguments into typed values | `args: (a) => a.snowflake().duration().rest()` → `ctx.options` |
+
+**Interactivity (components)**
+
+| Want to… | Reach for |
+| --- | --- |
+| A clickable button | `button({ id, run })` → `row(btn.build(...))` |
+| A URL button (no handler) | `linkButton` |
+| A dropdown of fixed options | `stringSelect` |
+| Pick users / roles / channels / mentionables | `userSelect` / `roleSelect` / `channelSelect` / `mentionableSelect` |
+| A form with text fields | `modal` + `textInput` |
+| Carry data through a component | custom-id params `id: "x:{id}"` → `ctx.params.id` |
+| A paged list with next/prev | `paginate(...)` |
+| An "Are you sure?" yes/no gate | `confirm(...)` |
+
+**Replies & UX**
+
+| Want to… | Reach for |
+| --- | --- |
+| Reply, public or hidden | `ctx.reply(...)` / `ctx.replyEphemeral(...)` |
+| Work that takes >3s | `ctx.defer()` then `ctx.editReply(...)` |
+| A styled success/error/info/warn embed | `ctx.success/error/info/warn(...)` |
+| "Reply, edit, or follow-up — whichever fits" | `ctx.send(...)` |
+
+**Cross-cutting concerns**
+
+| Want to… | Reach for |
+| --- | --- |
+| React to gateway events | `event(name, run)`; once on startup → `event("clientReady", ...)` |
+| Rate-limit a command/handler | `cooldown` (per-command or client-wide) |
+| Restrict by role / permission / owner / guild | guards: `requireAnyRole` / `requireUserPermissions` / `requireOwner` / `guildOnly` |
+| Run jobs on cron or interval | `task({ cron \| interval })` / `client.schedule(...)` |
+| Delay once / staged follow-ups / recover on restart | `client.scheduler.delay` / `followUp` / `reconcile` |
+| Structured logs to file/webhook | `client.logger` + `consoleSink` / `jsonlSink` / `webhookSink` |
+| Track who used what | `new SpearClient({ usage })` + `MemoryUsageStore` / `JsonFileUsageStore` |
+| Read typed env / load `.env` | `env.string/number/boolean/require` (auto-loaded on `start()`) |
+
+**Utilities (primitives)**
+
+| Want to… | Reach for |
+| --- | --- |
+| Stop concurrent runs per key (e.g. per user) | `KeyedLock` |
+| Fetch that returns `null` instead of throwing | `safeFetch.{member,channel,message,user,guild,role}` |
+| Format/parse `"1h30m"` durations | `formatDuration` / `parseDuration` |
+| Render `<t:…>` Discord timestamps | `discordTimestamp` / `relativeTimestamp` |
+| In-memory cache / counters / rate-limit window | `MemoryCache` |
+| Load JSON/JSON5/YAML config | `loadConfig` |
+
 ## Client
 
 ```ts
-new SpearClient(options?: Partial<ClientOptions>) // intents optional → Intents.default
+new SpearClient(options?: Partial<ClientOptions> & SpearOptions) // intents optional → Intents.default; SpearOptions: logger/dotenv/cooldown/prefix/usage/embeds/guards
 client.commands   // CommandRegistry
 client.events     // EventRegistry
 client.components // ComponentRegistry
@@ -18,7 +89,9 @@ client.start(token?): Promise<this>                    // login; falls back to D
 client.deployCommands({ guildId? }): Promise<DeployResult>      // after start()
 client.deployAllCommands({ guildId?, applicationId?, strategy?: "diff", dryRun? }) // slash + context menus
 client.schedule(taskConfig); client.scheduler          // TaskScheduler
-client.cooldowns; client.prefix; client.usage; client.logger; client.embeds
+client.enableGracefulShutdown({ onShutdown?, timeoutMs? }): () => void  // clean SIGINT/SIGTERM teardown
+client.cooldowns; client.prefix; client.usage; client.logger; client.embeds; client.contextMenus
+new SpearClient({ autoDefer: true })   // default auto-defer for slash + context-menu handlers
 
 const Intents = { none: [], default: [Guilds], guilds: [Guilds, GuildMembers],
                   messages: [Guilds, GuildMessages, MessageContent], all: /* every intent */ }
@@ -28,7 +101,7 @@ const Intents = { none: [], default: [Guilds], guilds: [Guilds, GuildMembers],
 
 ```ts
 command({ name, description, options?, defaultMemberPermissions?, nsfw?, guildOnly?,
-          nameLocalizations?, descriptionLocalizations?, guards?, cooldown?, run })
+          nameLocalizations?, descriptionLocalizations?, guards?, cooldown?, autoDefer?, run })
 commandGroup({ name, description, subcommands?, groups?, defaultMemberPermissions?, nsfw?, guildOnly?, ... })
 subcommand({ description, options?, run, ... })
 subcommandGroup({ description, subcommands, ... })
@@ -85,10 +158,12 @@ event({ name, once?, run })
 
 ```ts
 reply(input) · replyEphemeral(input) · defer({ ephemeral? }) · editReply(input) ·
-followUp(input) · send(input) · error(message)
+followUp(input) · send(input)
 success(input) · info(input) · warn(input) · error(input)                 // preset embeds, state-aware
 replySuccess/replyInfo/replyWarn/replyError(input)
 client · user · member · guild · guildId · channel · channelId · locale · deferred · replied
+botPermissions · botMissing(perm) · userMissing(perm)                      // permission preflight (zero-fetch)
+awaitMessageFrom(userId?, { time?, filter? }) · awaitModal(modal, { time?, filter? })  // → T | null
 // ReplyInput = string | (InteractionReplyOptions & { ephemeral?: boolean })
 ```
 
@@ -155,7 +230,7 @@ confirm(interaction, { body, title?, confirm?, cancel?, user?, timeoutMs?, ephem
 
 ```ts
 client.embeds.{ error|success|info|warn|build(level, input) }
-createEmbeds(opts?)  // alias for new Embeds(opts)
+new Embeds(opts?); defaultEmbeds   // shared default used when client.embeds is unset
 new SpearClient({ embeds: { /* colors/icons per level */ } })
 // BaseContext exposes ctx.success/info/warn/error + replySuccess/Info/Warn/Error
 ```
@@ -201,7 +276,7 @@ client.load(dir, { extensions?: readonly string[], recursive? })  // defaults [.
 new KeyedLock(); lock.tryAcquire(key, ttl?); lock.run(key, fn, { onBusy?, ttl? }); lock.isHeld(key); lock.forget(key); lock.dispose()
 safeFetch.{ member, channel, message, user, guild, role, try }  // each returns T | null
 withSafeTimeout(promise, ms)  // T | null
-formatDuration(ms, { locale?: "en"|"tr"|UnitLabels, largest?, units? })
+formatDuration(ms, { locale?: string | custom-labels, largest?, units? })  // "en"|"en-US"|"en-GB"|"tr"|"tr-TR" or a custom label set
 parseDuration(input): number | null
 discordTimestamp(date, style?: "t"|"T"|"d"|"D"|"f"|"F"|"R"); relativeTimestamp(date)
 new MemoryCache()  // CacheStore: get/set/delete/has/increment/rateLimit/clear (TTL + counters + fixed-window rate limit)
@@ -209,6 +284,42 @@ loadConfig({ file, parser?, schema?, encoding? }); loadConfigAsync(opts)   // JS
 lookup(table, resourceName?) -> (key) => value
 ```
 
+## Reliability, permissions, storage & collectors
+
+```ts
+// Auto-defer — dodge "Unknown interaction" (10062) on slow handlers
+command({ autoDefer: true | { ephemeral?, delayMs? } }); new SpearClient({ autoDefer: true })
+armAutoDefer(interaction, config) -> cancel(); normalizeAutoDefer(input); DEFAULT_AUTO_DEFER_DELAY_MS = 2000
+
+// Graceful shutdown
+client.enableGracefulShutdown({ signals?, timeoutMs?, exit?, onShutdown?, logger? }) -> dispose()
+gracefulShutdown(client, options)   // standalone variant
+
+// Permissions & moderation
+missingPermissions(channel, who, required) -> PermissionsString[]; botMissingPermissions(channel, required)
+hasPermissions(channel, who, required); compareRoles(a, b); canActOn(actor, target); formatPermissions(perm)
+moderationCheck({ moderator, target, me?, action? }) -> { ok: true } | { ok: false, reason }
+
+// Persistent storage + per-guild settings
+new MemoryStore(); new JsonStore(path)   // KeyValueStore: get/set/has/delete/keys/clear
+namespaced(store, prefix)
+createSettings({ store, defaults, namespace? }) -> { defaults, store, get(id), set(id, patch), reset(id) }
+
+// Collectors (all resolve null on timeout)
+awaitMessage(channel, { filter?, time? }); awaitComponent(message, { filter?, time?, componentType? })
+showAndAwaitModal(interaction, modal, { time?, filter? })
+
+// Discord errors
+isDiscordError(err, DiscordErrorCode.UnknownMessage?); isHTTPError(err); isRateLimitError(err)
+explainDiscordError(err) -> string | null; DiscordErrorCode.{ UnknownMessage, UnknownInteraction, MissingPermissions, ... }
+
+// Message formatting
+truncate(text, max, suffix?); chunkMessage(text, { max? }) -> string[]; MESSAGE_CHARACTER_LIMIT = 2000
+
+// Dynamic prefixes
+new SpearClient({ prefix: { prefix?, dynamic: (message) => string | string[] | null } })
+```
+
 ## Error handling
 
 ```ts

package/AGENTS.md

@@ -32,6 +32,87 @@ logging, usage tracking and dotenv. Install: `npm install spearkit discord.js`.
    `T | undefined`, `choices` narrow to a literal union, custom-id `{param}`s and
    modal field keys are typed. Don't cast; don't annotate handler args.
 
+## Use cases — reach for
+
+Map the task to the API. Patterns and signatures are below and in `docs/`.
+
+**Bot setup & lifecycle**
+
+| Want to… | Reach for |
+| --- | --- |
+| Start a bot and connect | `new SpearClient({ intents })` + `await client.start(token)` |
+| Choose gateway intents | `Intents.none / default / guilds / messages / all` |
+| Wire up handlers | `client.register(...)`; one file per handler → `client.load(dir)` |
+| Push commands to Discord | `client.deployCommands({ guildId })`; slash + context menus, safe CI → `client.deployAllCommands({ strategy: "diff", dryRun })` |
+| Package a reusable feature | `definePlugin(...)` + `client.use(...)` |
+| Migrate an existing discord.js bot | import from `"spearkit"`, swap `Client` → `SpearClient` |
+
+**Commands & input**
+
+| Want to… | Reach for |
+| --- | --- |
+| A slash command | `command({ name, description, run })` |
+| Typed inputs to a command | `options: { x: option.string/integer/number/boolean/user/channel/role/mentionable/attachment(...) }` |
+| Group many commands under one name | `commandGroup` + `subcommand` / `subcommandGroup` |
+| Suggest values while the user types | `option.string({ autocomplete })` |
+| A right-click "Apps" action on a user/message | `userCommand` / `messageCommand` |
+| A classic `!text` command | `prefixCommand(...)` + `new SpearClient({ prefix })` |
+| Parse `!cmd` arguments into typed values | `args: (a) => a.snowflake().duration().rest()` → `ctx.options` |
+| Avoid `Unknown interaction` (10062) on slow work | `command({ autoDefer: true })` / `new SpearClient({ autoDefer: true })` |
+
+**Interactivity (components)**
+
+| Want to… | Reach for |
+| --- | --- |
+| A clickable button | `button({ id, run })` → `row(btn.build(...))` |
+| A URL button (no handler) | `linkButton` |
+| A dropdown of fixed options | `stringSelect` |
+| Pick users / roles / channels / mentionables | `userSelect` / `roleSelect` / `channelSelect` / `mentionableSelect` |
+| A form with text fields | `modal` + `textInput` |
+| Carry data through a component | custom-id params `id: "x:{id}"` → `ctx.params.id` |
+| A paged list with next/prev | `paginate(...)` |
+| An "Are you sure?" yes/no gate | `confirm(...)` |
+
+**Replies & UX**
+
+| Want to… | Reach for |
+| --- | --- |
+| Reply, public or hidden | `ctx.reply(...)` / `ctx.replyEphemeral(...)` |
+| Work that takes >3s | `ctx.defer()` then `ctx.editReply(...)` |
+| A styled success/error/info/warn embed | `ctx.success/error/info/warn(...)` |
+| "Reply, edit, or follow-up — whichever fits" | `ctx.send(...)` |
+
+**Cross-cutting concerns**
+
+| Want to… | Reach for |
+| --- | --- |
+| React to gateway events | `event(name, run)`; once on startup → `event("clientReady", ...)` |
+| Rate-limit a command/handler | `cooldown` (per-command or client-wide) |
+| Restrict by role / permission / owner / guild | guards: `requireAnyRole` / `requireUserPermissions` / `requireOwner` / `guildOnly` |
+| Run jobs on cron or interval | `task({ cron \| interval })` / `client.schedule(...)` |
+| Delay once / staged follow-ups / recover on restart | `client.scheduler.delay` / `followUp` / `reconcile` |
+| Structured logs to file/webhook | `client.logger` + `consoleSink` / `jsonlSink` / `webhookSink` |
+| Track who used what | `new SpearClient({ usage })` + `MemoryUsageStore` / `JsonFileUsageStore` |
+| Read typed env / load `.env` | `env.string/number/boolean/require` (auto-loaded on `start()`) |
+| Shut down cleanly on SIGINT/SIGTERM | `client.enableGracefulShutdown({ onShutdown })` |
+| Permission / role-hierarchy preflight | `moderationCheck(...)`, `missingPermissions(...)`, `canActOn(...)`, `ctx.botMissing(...)` |
+| Wait for a reply / click / modal submission | `ctx.awaitMessageFrom(...)` / `ctx.awaitModal(...)` / `awaitComponent(...)` |
+| Branch on a Discord API error | `isDiscordError(err, DiscordErrorCode.X)` / `explainDiscordError(err)` |
+| Per-guild prefix from a store | `prefix: { dynamic: (message) => ... }` |
+
+**Utilities (primitives)**
+
+| Want to… | Reach for |
+| --- | --- |
+| Stop concurrent runs per key (e.g. per user) | `KeyedLock` |
+| Fetch that returns `null` instead of throwing | `safeFetch.{member,channel,message,user,guild,role}` |
+| Format/parse `"1h30m"` durations | `formatDuration` / `parseDuration` |
+| Render `<t:…>` Discord timestamps | `discordTimestamp` / `relativeTimestamp` |
+| In-memory cache / counters / rate-limit window | `MemoryCache` |
+| Load JSON/JSON5/YAML config | `loadConfig` |
+| Persist key-value data / per-guild settings | `MemoryStore` / `JsonStore` + `createSettings({ store, defaults })` |
+| Split text to Discord's 2000-char limit | `chunkMessage(text)` / `truncate(text, max)` |
+
 ## Canonical patterns
 
 ### Client + lifecycle
@@ -114,7 +195,7 @@ modals add `ctx.fields`.
 `ctx.deferred/replied`. For hidden replies prefer `ctx.replyEphemeral(...)` or
 `ctx.reply({ content, ephemeral: true })` — spearkit normalizes it.
 
-## Subsystems (each has a guide in docs/)
+## Subsystems (most have a dedicated guide in docs/; all are in the API reference)
 
 - **Guards** — `guards: [...]` on `command`/`prefixCommand`/`button`/`userCommand`/
   `messageCommand`, or client-wide `new SpearClient({ guards })`. Helpers:
@@ -145,6 +226,22 @@ modals add `ctx.fields`.
 - **Primitives** — `KeyedLock`, `safeFetch.{member,channel,message,user,guild,role,try}`,
   `formatDuration`/`parseDuration`/`discordTimestamp`/`relativeTimestamp`,
   `MemoryCache`, `loadConfig`.
+- **Auto-defer** — `command({ autoDefer: true | { ephemeral?, delayMs? } })` or
+  `new SpearClient({ autoDefer: true })`; auto-`deferReply()` before Discord's 3s
+  window so slow handlers don't 10062. Respond via `ctx.send`/`ctx.editReply`.
+- **Graceful shutdown** — `client.enableGracefulShutdown({ onShutdown, timeoutMs? })`
+  (or `gracefulShutdown(client, ...)`); clean `SIGINT`/`SIGTERM` teardown.
+- **Permissions & moderation** — `missingPermissions`, `botMissingPermissions`,
+  `hasPermissions`, `compareRoles`, `canActOn`, `moderationCheck`, `formatPermissions`;
+  on context: `ctx.botPermissions`, `ctx.botMissing(...)`, `ctx.userMissing(...)`.
+- **Persistent storage** — `MemoryStore`/`JsonStore` (`KeyValueStore`), `namespaced(...)`,
+  and typed per-guild `createSettings({ store, defaults, namespace? })`.
+- **Collectors** — `ctx.awaitMessageFrom(...)`, `ctx.awaitModal(...)`, plus standalone
+  `awaitMessage`, `awaitComponent`, `showAndAwaitModal` (all resolve `null` on timeout).
+- **Discord errors** — `isDiscordError(err, DiscordErrorCode.X)`, `isHTTPError`,
+  `isRateLimitError`, `explainDiscordError`; named `DiscordErrorCode` map.
+- **Message formatting** — `chunkMessage(text)` (2000-char-safe split), `truncate(text, max)`,
+  `MESSAGE_CHARACTER_LIMIT`.
 
 ## Common mistakes to avoid
 

package/README.md

@@ -15,15 +15,15 @@ npm install spearkit discord.js
 ## Batteries included
 
 - **Type-safe slash commands**, options, subcommands, autocomplete, buttons, selects and modals — no `interactionCreate` switch.
-- **Cooldowns** — per user/role/guild/channel, with exemptions and per-role/per-user overrides ([guide](./docs/cooldown.md)).
+- **Cooldowns** — per user/guild/channel/global, with per-role/per-user exemptions and overrides ([guide](./docs/cooldown.md)).
 - **Scheduled tasks** — cron and interval jobs, started on ready ([guide](./docs/scheduler.md)).
 - **Prefix commands** — classic `!text` commands that share cooldowns ([guide](./docs/prefix.md)).
 - **Structured logging** — leveled, scoped, pluggable; every error flows through it ([guide](./docs/logging.md)).
 - **Usage tracking** — record who used what to a database and/or a Discord channel ([guide](./docs/usage.md)).
 - **dotenv built in** — auto-load `.env` and read typed env vars ([guide](./docs/env.md)).
 - **Plugins & file-based loading** for organising larger bots.
-- **Guards** — declarative `requireAnyRole`/`requireUserPermissions`/`guildOnly`/`requireOwner` preconditions on commands, components and prefix commands ([API ref](./docs/api-reference.md#guards--declarative-preconditions)).
-- **Context-menu commands** — `userCommand` / `messageCommand` with typed `targetUser` / `targetMessage` ([API ref](./docs/api-reference.md#context-menu-commands)).
+- **Guards** — declarative `requireAnyRole`/`requireUserPermissions`/`guildOnly`/`requireOwner` preconditions on commands, components and prefix commands ([guide](./docs/guards.md)).
+- **Context-menu commands** — `userCommand` / `messageCommand` with typed `targetUser` / `targetMessage` ([guide](./docs/context-menus.md)).
 - **Preset embeds** — `ctx.success/info/warn/error` and `client.embeds` factory with configurable colors/icons ([API ref](./docs/api-reference.md#embeds--preset-replies)).
 - **Pagination & confirmation** — `paginate(...)` and `confirm(...)` button flows with user-only filter and timeout.
 - **Typed prefix args** — `prefixCommand({ args: a => a.snowflake("target").duration("d").rest("reason"), run: ctx => ctx.options })`.
@@ -31,6 +31,13 @@ npm install spearkit discord.js
 - **Logger transports** — multi-sink (`consoleSink`, `jsonlSink`, `webhookSink`); per-level routing.
 - **Scheduler extras** — `scheduler.delay/followUp/reconcile` for one-shot jobs and on-ready recovery.
 - **Deploy strategy** — `deployAllCommands({ dryRun, strategy: "diff" })` for safe CI deploys.
+- **Auto-defer** — `command({ autoDefer: true })` / `new SpearClient({ autoDefer: true })` to dodge `Unknown interaction` (10062) on slow handlers ([API ref](./docs/api-reference.md#auto-defer)).
+- **Graceful shutdown** — `client.enableGracefulShutdown({ onShutdown })` for clean `SIGINT`/`SIGTERM` teardown ([API ref](./docs/api-reference.md#graceful-shutdown)).
+- **Permissions & moderation** — `moderationCheck`, `missingPermissions`, `canActOn`, `ctx.botMissing(...)` role-hierarchy/permission preflights ([API ref](./docs/api-reference.md#permissions--moderation)).
+- **Persistent storage** — `MemoryStore`/`JsonStore` key-value stores + typed per-guild `createSettings(...)` ([API ref](./docs/api-reference.md#persistent-storage)).
+- **Collectors** — `ctx.awaitMessageFrom(...)`, `ctx.awaitModal(...)`, `awaitComponent(...)` without hand-rolled collectors ([API ref](./docs/api-reference.md#collectors)).
+- **Discord error helpers** — `isDiscordError(err, DiscordErrorCode.UnknownMessage)`, `explainDiscordError(...)` ([API ref](./docs/api-reference.md#discord-errors)).
+- **Dynamic prefixes** — per-guild prefix resolution via `prefix: { dynamic }` ([guide](./docs/prefix.md#dynamic-per-guild-prefixes)).
 
 ## Documentation