@adaptic/maestro 1.10.0 → 1.10.2

package/scripts/setup/init-slack-socket-mode.mjs

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+/**
+ * init-slack-socket-mode.mjs — Interactive init for the Slack Socket Mode
+ * feature.
+ *
+ * Called by `maestro init slack-socket-mode --apply`. Walks the operator
+ * through enabling Socket Mode on the Slack app, generating an app-level
+ * token with the `connections:write` scope, and dropping it into .env.
+ * Then ensures the launchd plist exists + loads it.
+ *
+ * Safe to run repeatedly — every step is idempotent and the script never
+ * overwrites an existing token. If the operator already configured the
+ * feature, the script confirms each piece is in place and exits 0.
+ */
+import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENT_DIR = process.env.AGENT_ROOT || process.env.AGENT_DIR || resolve(__dirname, "..", "..");
+
+const ok = (m) => process.stdout.write(`[init-slack-socket-mode]  ✓ ${m}\n`);
+const warn = (m) => process.stdout.write(`[init-slack-socket-mode]  ⚠ ${m}\n`);
+const info = (m) => process.stdout.write(`[init-slack-socket-mode]    ${m}\n`);
+const fail = (m) => process.stderr.write(`[init-slack-socket-mode]  ✗ ${m}\n`);
+
+// ---------------------------------------------------------------------------
+// Step 1 — Print the Slack admin walkthrough
+// ---------------------------------------------------------------------------
+
+function printWalkthrough() {
+  process.stdout.write(`
+================================================================================
+Slack Socket Mode Setup — 3 steps in the Slack admin UI
+================================================================================
+
+This feature gives the agent a persistent WebSocket to Slack so DMs and
+@mentions arrive in real time instead of being polled every 60 seconds.
+You need a Slack app with Socket Mode enabled and an app-level token.
+
+Step 1 — Create or open the agent's Slack app
+   Open https://api.slack.com/apps
+   If you already have an app for this agent's bot, click into it.
+   Otherwise: "Create New App" → "From scratch" → pick a workspace.
+
+Step 2 — Enable Socket Mode + Event Subscriptions
+   In the left sidebar:
+     a. "Socket Mode" → toggle ON
+        When prompted, generate an App-Level Token. Give it a name
+        (e.g. "maestro-socket") and add the connections:write scope.
+        Copy the token (xapp-1-…) somewhere safe — you'll paste it
+        below in step 3.
+     b. "Event Subscriptions" → toggle ON
+        Subscribe to BOT events:
+          - message.channels
+          - message.groups
+          - message.im
+          - message.mpim
+          - app_mention
+        Reinstall the app to your workspace when prompted.
+
+Step 3 — Add the app-level token to .env
+   Paste it on the prompt below, or skip and add it manually as:
+     SLACK_APP_LEVEL_TOKEN=xapp-1-…
+   in ${join(AGENT_DIR, ".env")}.
+
+================================================================================
+`);
+}
+
+// ---------------------------------------------------------------------------
+// Step 2 — Check .env for SLACK_APP_LEVEL_TOKEN and offer to add it
+// ---------------------------------------------------------------------------
+
+/**
+ * Parse `.env` into a plain object. Best-effort — no fancy quoting. Used
+ * only to detect whether the token line is present.
+ */
+function readEnv(envPath) {
+  if (!existsSync(envPath)) return {};
+  const map = {};
+  for (const line of readFileSync(envPath, "utf-8").split("\n")) {
+    const m = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
+    if (m) map[m[1]] = m[2].trim().replace(/^["']|["']$/g, "");
+  }
+  return map;
+}
+
+/**
+ * Append a single `KEY=VALUE` line to .env. Does NOT rewrite existing keys
+ * — the operator should hand-edit if they need to change a value.
+ */
+function appendEnvLine(envPath, key, value) {
+  if (!existsSync(envPath)) {
+    writeFileSync(envPath, `${key}=${value}\n`);
+    return;
+  }
+  const body = readFileSync(envPath, "utf-8");
+  const suffix = body.endsWith("\n") ? "" : "\n";
+  appendFileSync(envPath, `${suffix}${key}=${value}\n`);
+}
+
+async function promptForToken() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question("Paste your SLACK_APP_LEVEL_TOKEN (xapp-1-…), or press ENTER to skip: ");
+    return answer.trim();
+  } finally {
+    rl.close();
+  }
+}
+
+async function ensureTokenInEnv() {
+  const envPath = join(AGENT_DIR, ".env");
+  const env = readEnv(envPath);
+  const existing = env.SLACK_APP_LEVEL_TOKEN || "";
+  if (existing.startsWith("xapp-")) {
+    ok("SLACK_APP_LEVEL_TOKEN already set in .env");
+    return true;
+  }
+
+  // Skip the prompt when running in a non-interactive environment (CI,
+  // upgrade in --apply mode, etc). The operator can re-run interactively
+  // later or hand-edit .env.
+  if (!process.stdin.isTTY) {
+    warn("SLACK_APP_LEVEL_TOKEN missing and stdin is non-interactive — skipping prompt.");
+    info(`Add the token manually to ${envPath}:`);
+    info("  SLACK_APP_LEVEL_TOKEN=xapp-1-…");
+    return false;
+  }
+
+  const token = await promptForToken();
+  if (!token) {
+    warn("No token provided — skipping. Add it manually before launchd-loading the plist.");
+    info(`  echo 'SLACK_APP_LEVEL_TOKEN=xapp-1-…' >> ${envPath}`);
+    return false;
+  }
+  if (!token.startsWith("xapp-")) {
+    fail(`Token must start with 'xapp-' — got '${token.slice(0, 8)}…'. Skipping.`);
+    return false;
+  }
+  appendEnvLine(envPath, "SLACK_APP_LEVEL_TOKEN", token);
+  ok(`SLACK_APP_LEVEL_TOKEN appended to ${envPath}`);
+  return true;
+}
+
+// ---------------------------------------------------------------------------
+// Step 3 — Ensure the launchd plist exists, then load it
+// ---------------------------------------------------------------------------
+
+/**
+ * Derive the agent's launchd label prefix from config/agent.json or fall
+ * back to the directory name. Mirrors the resolution in
+ * scripts/local-triggers/generate-plists.sh.
+ */
+function resolveAgentFirstName() {
+  try {
+    const a = JSON.parse(readFileSync(join(AGENT_DIR, "config/agent.json"), "utf-8"));
+    if (a.firstName && typeof a.firstName === "string") {
+      return a.firstName.toLowerCase();
+    }
+  } catch { /* try fallback */ }
+  return AGENT_DIR.split("/").pop().replace(/-ai$/, "").toLowerCase();
+}
+
+function regenPlistsIfNeeded(firstName) {
+  const plistDir = join(AGENT_DIR, "scripts/local-triggers/plists");
+  const expected = join(plistDir, `ai.adaptic.${firstName}-slack-socket.plist`);
+  if (existsSync(expected)) {
+    ok(`plist already generated: ${expected}`);
+    return expected;
+  }
+  // Run the generator. It's idempotent and lives in the agent repo.
+  const generator = join(AGENT_DIR, "scripts/local-triggers/generate-plists.sh");
+  if (!existsSync(generator)) {
+    warn(`generator missing at ${generator} — cannot create plist`);
+    return null;
+  }
+  info(`generating plists via ${generator}`);
+  const r = spawnSync("/bin/bash", [generator], { cwd: AGENT_DIR, encoding: "utf-8" });
+  if (r.status !== 0) {
+    fail(`generator failed (exit ${r.status}): ${(r.stderr || "").trim()}`);
+    return null;
+  }
+  if (existsSync(expected)) {
+    ok(`plist generated: ${expected}`);
+    return expected;
+  }
+  warn(`generator ran but ${expected} not found. Re-check generate-plists.sh.`);
+  return null;
+}
+
+/**
+ * Copy the generated plist into ~/Library/LaunchAgents/ and launchctl-load
+ * it. Idempotent: if already loaded, unload-then-load to pick up changes.
+ */
+function loadPlist(plistPath, label) {
+  const home = process.env.HOME || "";
+  if (!home) {
+    warn("HOME not set — cannot install plist");
+    return false;
+  }
+  const installedDir = join(home, "Library/LaunchAgents");
+  mkdirSync(installedDir, { recursive: true });
+  const installed = join(installedDir, `${label}.plist`);
+
+  // Copy (preserve atomicity by writing-then-renaming).
+  try {
+    const body = readFileSync(plistPath, "utf-8");
+    writeFileSync(installed + ".tmp", body);
+    // Use rename to make the install atomic.
+    spawnSync("/bin/mv", [installed + ".tmp", installed], { encoding: "utf-8" });
+    ok(`copied to ${installed}`);
+  } catch (err) {
+    fail(`could not install plist: ${err.message}`);
+    return false;
+  }
+
+  // Unload any existing instance, then load the fresh one.
+  spawnSync("launchctl", ["unload", installed], { encoding: "utf-8" });
+  const loadRes = spawnSync("launchctl", ["load", installed], { encoding: "utf-8" });
+  if (loadRes.status !== 0) {
+    warn(`launchctl load returned ${loadRes.status}: ${(loadRes.stderr || "").trim()}`);
+    info("You can retry manually: launchctl load " + installed);
+    return false;
+  }
+  ok(`launchctl loaded ${label}`);
+  return true;
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  printWalkthrough();
+  const tokenOk = await ensureTokenInEnv();
+
+  const firstName = resolveAgentFirstName();
+  const label = `ai.adaptic.${firstName}-slack-socket`;
+  const plistPath = regenPlistsIfNeeded(firstName);
+
+  if (plistPath && tokenOk) {
+    loadPlist(plistPath, label);
+  } else if (plistPath && !tokenOk) {
+    info("Skipping launchctl load — add SLACK_APP_LEVEL_TOKEN to .env first, then run:");
+    info(`  launchctl load ~/Library/LaunchAgents/${label}.plist`);
+  }
+
+  ok("init-slack-socket-mode complete");
+  info("Verify with: maestro doctor   (checks token + plist + recent connect log)");
+}
+
+main().catch((err) => {
+  fail(`unexpected error: ${err.message}`);
+  process.stderr.write(`${err.stack}\n`);
+  process.exit(1);
+});