refactor: split slack/discord/session maintenance helpers

src/infra/stable-node-path.ts

@@ -0,0 +1,39 @@
+import fs from "node:fs/promises";
+
+/**
+ * Homebrew Cellar paths (e.g. /opt/homebrew/Cellar/node/25.7.0/bin/node)
+ * break when Homebrew upgrades Node and removes the old version directory.
+ * Resolve these to a stable Homebrew-managed path that survives upgrades:
+ *   - Default formula "node":  <prefix>/opt/node/bin/node  or  <prefix>/bin/node
+ *   - Versioned formula "node@22":  <prefix>/opt/node@22/bin/node  (keg-only)
+ */
+export async function resolveStableNodePath(nodePath: string): Promise<string> {
+  const cellarMatch = nodePath.match(/^(.+?)\/Cellar\/([^/]+)\/[^/]+\/bin\/node$/);
+  if (!cellarMatch) {
+    return nodePath;
+  }
+  const prefix = cellarMatch[1]; // e.g. /opt/homebrew
+  const formula = cellarMatch[2]; // e.g. "node" or "node@22"
+
+  // Try the Homebrew opt symlink first — works for both default and versioned formulas.
+  const optPath = `${prefix}/opt/${formula}/bin/node`;
+  try {
+    await fs.access(optPath);
+    return optPath;
+  } catch {
+    // fall through
+  }
+
+  // For the default "node" formula, also try the direct bin symlink.
+  if (formula === "node") {
+    const binPath = `${prefix}/bin/node`;
+    try {
+      await fs.access(binPath);
+      return binPath;
+    } catch {
+      // fall through
+    }
+  }
+
+  return nodePath;
+}