feat(walkthrough): mention /close and /reopen as command mentions (#44)

* feat(walkthrough): mention /close and /reopen as command mentions

* refactor(walkthrough): resolve command mentions inside message builder

Author: phorcys420

src/commands/util/walkthrough.ts

@@ -1,10 +1,12 @@
 import { config } from "@lib/config.js";
 
 import { isHelpPost as isHelpThread } from "@lib/discord/channels.js";
+import { getCommandMention } from "@lib/discord/commands.js";
 import issueCategorySelector from "@components/issueCategorySelector.js";
 
 import {
   type ChatInputCommandInteraction,
+  type Client,
   SlashCommandBuilder,
   ActionRowBuilder,
   type StringSelectMenuBuilder,
@@ -24,52 +26,63 @@ import {
   type InteractionReplyOptions,
 } from "discord.js";
 
-const resourcesMessage = {
-  flags: MessageFlags.IsComponentsV2,
-
-  components: [
-    new ContainerBuilder().addSectionComponents([
-      new SectionBuilder()
-        .addTextDisplayComponents(
-          new TextDisplayBuilder({ content: "Where to find logs" }),
-        )
-        .setButtonAccessory(
-          new ButtonBuilder()
-            .setStyle(ButtonStyle.Link)
-            .setLabel("Docs")
-            .setURL("https://coder.com/docs/admin/monitoring/logs"),
-        ),
-
-      new SectionBuilder()
-        .addTextDisplayComponents(
-          new TextDisplayBuilder({
-            content: "Troubleshooting templates",
-          }),
-        )
-        .setButtonAccessory(
-          new ButtonBuilder()
-            .setStyle(ButtonStyle.Link)
-            .setLabel("Docs")
-            .setURL("https://coder.com/docs/admin/templates/troubleshooting"),
-        ),
+async function buildResourcesMessage(client: Client) {
+  return {
+    flags: MessageFlags.IsComponentsV2,
 
-      new SectionBuilder()
+    components: [
+      new ContainerBuilder()
+        .addSectionComponents([
+          new SectionBuilder()
+            .addTextDisplayComponents(
+              new TextDisplayBuilder({ content: "Where to find logs" }),
+            )
+            .setButtonAccessory(
+              new ButtonBuilder()
+                .setStyle(ButtonStyle.Link)
+                .setLabel("Docs")
+                .setURL("https://coder.com/docs/admin/monitoring/logs"),
+            ),
+
+          new SectionBuilder()
+            .addTextDisplayComponents(
+              new TextDisplayBuilder({
+                content: "Troubleshooting templates",
+              }),
+            )
+            .setButtonAccessory(
+              new ButtonBuilder()
+                .setStyle(ButtonStyle.Link)
+                .setLabel("Docs")
+                .setURL(
+                  "https://coder.com/docs/admin/templates/troubleshooting",
+                ),
+            ),
+
+          new SectionBuilder()
+            .addTextDisplayComponents(
+              new TextDisplayBuilder({
+                content: "Troubleshooting networking",
+              }),
+            )
+            .setButtonAccessory(
+              new ButtonBuilder()
+                .setStyle(ButtonStyle.Link)
+                .setLabel("Docs")
+                .setURL(
+                  "https://coder.com/docs/admin/networking/troubleshooting",
+                ),
+            ),
+        ])
+        .addSeparatorComponents(new SeparatorBuilder())
         .addTextDisplayComponents(
           new TextDisplayBuilder({
-            content: "Troubleshooting networking",
+            content: `When your issue is resolved, use ${await getCommandMention(client, "close")} to close this post. Use ${await getCommandMention(client, "reopen")} to reopen it if needed.`,
           }),
-        )
-        .setButtonAccessory(
-          new ButtonBuilder()
-            .setStyle(ButtonStyle.Link)
-            .setLabel("Docs")
-            .setURL("https://coder.com/docs/admin/networking/troubleshooting"),
         ),
-    ]),
-
-    new SeparatorBuilder(),
-  ],
-};
+    ],
+  };
+}
 
 export function generateQuestion(
   question: string,
@@ -94,6 +107,8 @@ export async function doWalkthrough(
   if (await isHelpThread(channel)) {
     const threadChannel = channel as PublicThreadChannel; // necessary type cast, isHelpThread does the check already
 
+    const resourcesMessage = await buildResourcesMessage(channel.client);
+
     // Check for tags in the forum post
     const appliedTags = threadChannel.appliedTags ?? [];
     if (!appliedTags.includes(config.helpChannel.openedTag)) {

src/lib/discord/commands.ts

@@ -0,0 +1,19 @@
+import { config } from "@lib/config.js";
+
+import type { Client } from "discord.js";
+
+// Resolves a slash command mention (</name:id>) by looking the command ID up
+// from the ones the bot registered in the guild. Falls back to plain text if
+// the command cannot be found.
+export async function getCommandMention(
+  client: Client,
+  name: string,
+): Promise<string> {
+  const commands = await client.application.commands.fetch({
+    guildId: config.serverId,
+  });
+
+  const command = commands.find((cmd) => cmd.name === name);
+
+  return command ? `</${command.name}:${command.id}>` : `/${name}`;
+}