@goodnesshq/opencode-notification 0.1.8 → 0.2.1

package/.opencode/notify-init.mjs

@@ -36,6 +36,11 @@ const DEFAULTS = {
       server: "https://ntfy.sh",
       topic: "",
     },
+    telegram: {
+      enabled: false,
+      token: "",
+      chatId: "",
+    },
   },
   overrides: {
     includeGroups: [],
@@ -128,6 +133,20 @@ async function copySchema(cwd) {
   } catch {}
 }
 
+async function ensureGitignore(cwd) {
+  const gitignorePath = join(cwd, ".gitignore");
+  const entry = ".opencode/oc-notify.json";
+  try {
+    const content = await readFile(gitignorePath, "utf8");
+    const lines = content.split(/\r?\n/);
+    if (lines.some((line) => line.trim() === entry)) return;
+    const prefix = content.endsWith("\n") || content.length === 0 ? "" : "\n";
+    await writeFile(gitignorePath, content + prefix + entry + "\n", "utf8");
+  } catch {
+    await writeFile(gitignorePath, entry + "\n", "utf8");
+  }
+}
+
 function isInteractive() {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   if (process.env.CI) return false;
@@ -263,53 +282,50 @@ async function promptMultiSelect({
 
         const render = () => {
           const filtered = getFiltered();
-          if (cursor > Math.max(0, filtered.length - 1)) cursor = 0;
-
-          const lines = [];
-          lines.push(message);
-          lines.push(
-            `Filter: ${filter || "(type to filter)"} (${selected.size} selected)`,
-          );
-
-          if (filtered.length === 0) {
-            lines.push("  No matches");
-            renderPrompt(lines, state);
-            return;
-          }
-
-          const startIndex = Math.max(
-            0,
-            Math.min(
-              cursor - Math.floor(pageSize / 2),
-              Math.max(0, filtered.length - pageSize),
-            ),
+          if (cursor >= filtered.length) cursor = Math.max(0, filtered.length - 1);
+          const maxStart = Math.max(0, filtered.length - pageSize);
+          const pageStart = Math.min(
+            maxStart,
+            Math.max(0, cursor - Math.floor(pageSize / 2)),
           );
-          const endIndex = Math.min(startIndex + pageSize, filtered.length);
-          const visible = filtered.slice(startIndex, endIndex);
-
-          for (let index = 0; index < visible.length; index += 1) {
-            const actualIndex = startIndex + index;
-            const choice = visible[index];
-            const pointer = actualIndex === cursor ? ">" : " ";
-            const checked = selected.has(choice.value) ? "[x]" : "[ ]";
-            lines.push(` ${pointer} ${checked} ${choice.name}`);
+          const page = filtered.slice(pageStart, pageStart + pageSize);
+          const lines = [];
+          const header = filter ? `${message} (filter: ${filter})` : message;
+          lines.push(header);
+          lines.push("Use \u2191/\u2193 to move, space to toggle, enter to confirm");
+          if (!page.length) {
+            lines.push("  (no matches)");
+          } else {
+            for (let index = 0; index < page.length; index += 1) {
+              const choice = page[index];
+              const absoluteIndex = pageStart + index;
+              const pointer = absoluteIndex === cursor ? ">" : " ";
+              const mark = selected.has(choice.value) ? "x" : " ";
+              lines.push(` ${pointer} [${mark}] ${choice.name}`);
+            }
           }
-
           renderPrompt(lines, state);
         };
 
+        const toggle = () => {
+          const filtered = getFiltered();
+          const choice = filtered[cursor];
+          if (!choice) return;
+          if (selected.has(choice.value)) selected.delete(choice.value);
+          else selected.add(choice.value);
+        };
+
         const finish = () => {
-          const ordered = choices
+          const values = choices
             .filter((choice) => selected.has(choice.value))
             .map((choice) => choice.value);
-          const summary = ordered.length > 0 ? ordered.join(", ") : "(none)";
-          renderPrompt([`${message} ${summary}`], state);
+          renderPrompt([`${message} ${values.join(", ")}`], state);
           process.stdout.write("\n");
           cleanup();
-          resolve(ordered);
+          resolve(values);
         };
 
-        const onKey = (char, key) => {
+        const onKey = (_char, key) => {
           if (!key) return;
           if (key.ctrl && key.name === "c") {
             cleanup();
@@ -327,32 +343,24 @@ async function promptMultiSelect({
             return;
           }
           if (key.name === "space") {
-            const filtered = getFiltered();
-            const choice = filtered[cursor];
-            if (choice) {
-              if (selected.has(choice.value)) {
-                selected.delete(choice.value);
-              } else {
-                selected.add(choice.value);
-              }
-              render();
-            }
+            toggle();
+            render();
+            return;
+          }
+          if (key.name === "return" || key.name === "enter") {
+            finish();
             return;
           }
-          if (key.name === "backspace") {
-            if (filter.length > 0) {
+          if (key.name === "backspace" || key.name === "delete") {
+            if (filter) {
               filter = filter.slice(0, -1);
               cursor = 0;
               render();
             }
             return;
           }
-          if (key.name === "return" || key.name === "enter") {
-            finish();
-            return;
-          }
-          if (char && char.length === 1 && !key.ctrl && !key.meta) {
-            filter += char;
+          if (key.sequence && key.sequence.length === 1 && !key.ctrl && !key.meta) {
+            filter += key.sequence;
             cursor = 0;
             render();
           }
@@ -368,7 +376,6 @@ async function promptMultiSelect({
   );
 }
 
-
 async function sendTestNotification(config, repoName) {
   const title = config.title || `${repoName}@test`;
   const subtitle = "OpenCode Notify";
@@ -429,6 +436,31 @@ async function sendTestNotification(config, repoName) {
       console.log("Test ntfy notification failed.");
     }
   }
+
+  if (config.channels.telegram.enabled) {
+    try {
+      const token = config.channels.telegram.token?.trim();
+      const chatId = config.channels.telegram.chatId?.trim();
+      if (!token || !chatId) return;
+      const { execFileSync } = await import("node:child_process");
+      const url = `https://api.telegram.org/bot${token}/sendMessage`;
+      const payload = [title, subtitle, message].filter(Boolean).join("\n");
+      execFileSync("curl", [
+        "-sS",
+        "-X",
+        "POST",
+        url,
+        "--data-urlencode",
+        `chat_id=${chatId}`,
+        "--data-urlencode",
+        `text=${payload}`,
+        "--data-urlencode",
+        "disable_web_page_preview=true",
+      ]);
+    } catch {
+      console.log("Test Telegram notification failed.");
+    }
+  }
 }
 
 async function main() {
@@ -519,10 +551,17 @@ async function main() {
     ? await promptConfirm("Enable ntfy notifications?", true)
     : yesNo(await rl.question("Enable ntfy notifications? (Y/n) [Y] "), true);
 
+  const telegramEnabled = interactive
+    ? await promptConfirm("Enable Telegram notifications?", false)
+    : yesNo(await rl.question("Enable Telegram notifications? (y/N) [N] "), false);
+
   let globalConfig = await readJson(GLOBAL_CONFIG_PATH);
   if (!globalConfig) globalConfig = {};
   if (!globalConfig.ntfy) globalConfig.ntfy = {};
 
+  let telegramToken = "";
+  let telegramChatId = "";
+
   if (ntfyEnabled) {
     const serverInput = interactive
       ? await promptInput(
@@ -544,6 +583,24 @@ async function main() {
     if (topicInput.trim()) globalConfig.ntfy.topic = topicInput.trim();
   }
 
+  if (telegramEnabled) {
+    const tokenInput = interactive
+      ? await promptInput("Telegram bot token: ")
+      : await rl.question("Telegram bot token: ");
+    telegramToken = tokenInput.trim();
+    if (telegramToken) {
+      const updatesUrl = `https://api.telegram.org/bot${telegramToken}/getUpdates`;
+      console.log("\nFind your Telegram chat ID:");
+      console.log("  1) Send your bot a message in Telegram.");
+      console.log(`  2) Open ${updatesUrl} in a browser.`);
+      console.log("  3) Use message.chat.id (or channel_post.chat.id for channels).\n");
+    }
+    const chatIdInput = interactive
+      ? await promptInput("Telegram chat ID: ")
+      : await rl.question("Telegram chat ID: ");
+    telegramChatId = chatIdInput.trim();
+  }
+
   const detailLevel = interactive
     ? await promptSelect({
         message: "Detail level:",
@@ -607,20 +664,20 @@ async function main() {
     const hasTN = await commandExists("terminal-notifier");
     const hasBrew = await commandExists("brew");
     if (!hasTN && hasBrew) {
-        const installNow = interactive
-          ? await promptConfirm(
-              "terminal-notifier not found. Install with Homebrew now?",
-              false,
-            )
-          : yesNo(
-              await rl.question(
-                "terminal-notifier not found. Install with Homebrew now? (y/N) [N] ",
-              ),
-              false,
-            );
-        if (installNow) {
-          try {
-            const { execSync } = await import("node:child_process");
+      const installNow = interactive
+        ? await promptConfirm(
+            "terminal-notifier not found. Install with Homebrew now?",
+            false,
+          )
+        : yesNo(
+            await rl.question(
+              "terminal-notifier not found. Install with Homebrew now? (y/N) [N] ",
+            ),
+            false,
+          );
+      if (installNow) {
+        try {
+          const { execSync } = await import("node:child_process");
           execSync("brew install terminal-notifier", { stdio: "inherit" });
         } catch {
           console.log("Homebrew install failed. Falling back to AppleScript.");
@@ -649,6 +706,11 @@ async function main() {
         server: globalConfig.ntfy?.server || DEFAULTS.channels.ntfy.server,
         topic: globalConfig.ntfy?.topic || DEFAULTS.channels.ntfy.topic,
       },
+      telegram: {
+        enabled: telegramEnabled,
+        token: telegramToken,
+        chatId: telegramChatId,
+      },
     },
     overrides: {
       includeGroups,
@@ -668,6 +730,7 @@ async function main() {
     await ensureOpencodeDir(cwd);
     await writeJson(join(cwd, REPO_CONFIG_PATH), config);
     await copySchema(cwd);
+    await ensureGitignore(cwd);
   }
 
   const sendTest = interactive

package/.opencode/oc-notify.schema.json

@@ -66,6 +66,21 @@
               "type": "string"
             }
           }
+        },
+        "telegram": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "token": {
+              "type": "string"
+            },
+            "chatId": {
+              "type": "string"
+            }
+          }
         }
       }
     },

package/README.md

@@ -1,6 +1,6 @@
 # OpenCode Notifications
 
-This repo implements a per-repo notification plugin for OpenCode. It uses a repo-local config file (`.opencode/oc-notify.json`) and sends notifications to macOS Notification Center and ntfy.
+This repo implements a per-repo notification plugin for OpenCode. It uses a repo-local config file (`.opencode/oc-notify.json`) and sends notifications to macOS Notification Center, ntfy, and Telegram.
 
 ## Quick Start
 
@@ -24,6 +24,7 @@ npx @goodnesshq/opencode-notification install
 This only installs repo assets and prints next steps for manual setup.
 
 Before running the installer, create a unique ntfy topic and set up mobile notifications. See `docs/ntfy-topic.md`.
+If you plan to use Telegram, see `docs/telegram-chat-id.md` for how to find your chat ID.
 The installer uses an interactive, arrow-key prompt flow (with a non-interactive fallback in non-TTY environments).
 
 ## Config Schema
@@ -35,7 +36,7 @@ The config is defined in `.opencode/oc-notify.schema.json` and supports:
 - `tier`: `focus` | `full` | `custom`
 - `detailLevel`: `full` | `title-only`
 - `responseComplete`: trigger for completion notifications (default: `session.idle`)
-- `channels`: `mac` and `ntfy` settings
+- `channels`: `mac`, `ntfy`, and `telegram` settings
 - `overrides`: include/exclude groups
 - `dedupe`: in-memory TTL settings
 
@@ -58,7 +59,8 @@ The config is defined in `.opencode/oc-notify.schema.json` and supports:
   },
   "channels": {
     "mac": { "enabled": true, "method": "auto" },
-    "ntfy": { "enabled": true, "server": "https://ntfy.sh", "topic": "<your-topic>" }
+    "ntfy": { "enabled": true, "server": "https://ntfy.sh", "topic": "<your-topic>" },
+    "telegram": { "enabled": false, "token": "", "chatId": "" }
   }
 }
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodnesshq/opencode-notification",
-  "version": "0.1.8",
-  "description": "Per-repo notification plugin for OpenCode with macOS and ntfy delivery.",
+  "version": "0.2.1",
+  "description": "Per-repo notification plugin for OpenCode with macOS, ntfy, and Telegram delivery.",
   "type": "module",
   "bin": {
     "ocn": "bin/ocn.mjs"
@@ -18,7 +18,8 @@
     "notifications",
     "plugin",
     "ntfy",
-    "macos"
+    "macos",
+    "telegram"
   ],
   "license": "MIT"
 }

package/plugins/opencode-notifications.mjs

@@ -26,6 +26,11 @@ const DEFAULTS = {
       server: "https://ntfy.sh",
       topic: "",
     },
+    telegram: {
+      enabled: false,
+      token: "",
+      chatId: "",
+    },
   },
   overrides: {
     includeGroups: [],
@@ -170,6 +175,20 @@ function normalizeConfig(raw, globalConfig) {
           normalizeString(globalSource.ntfy?.topic, "")
         ),
       },
+      telegram: {
+        enabled: normalizeBool(
+          source.channels?.telegram?.enabled,
+          DEFAULTS.channels.telegram.enabled
+        ),
+        token: normalizeString(
+          source.channels?.telegram?.token,
+          DEFAULTS.channels.telegram.token
+        ),
+        chatId: normalizeString(
+          source.channels?.telegram?.chatId,
+          DEFAULTS.channels.telegram.chatId
+        ),
+      },
     },
     overrides: {
       includeGroups: sanitizeGroups(normalizeArray(source.overrides?.includeGroups)),
@@ -634,6 +653,23 @@ export default async function opencodeNotify(input) {
     } catch {}
   }
 
+  function buildTelegramMessage(notification) {
+    const parts = [notification.title, notification.subtitle, notification.body].filter(Boolean);
+    return parts.join("\n");
+  }
+
+  async function notifyTelegram(notification, config) {
+    if (!config.channels.telegram.enabled) return;
+    const token = config.channels.telegram.token?.trim();
+    const chatId = config.channels.telegram.chatId?.trim();
+    if (!token || !chatId) return;
+    try {
+      const url = `https://api.telegram.org/bot${token}/sendMessage`;
+      const message = buildTelegramMessage(notification);
+      await $`curl -sS -X POST ${url} --data-urlencode ${"chat_id=" + chatId} --data-urlencode ${"text=" + message} --data-urlencode ${"disable_web_page_preview=true"}`.quiet();
+    } catch {}
+  }
+
   return {
     event: async ({ event }) => {
       const payload = event?.payload ?? event;
@@ -678,6 +714,7 @@ export default async function opencodeNotify(input) {
 
       await notifyMac(notification, config);
       await notifyNtfy(notification, config);
+      await notifyTelegram(notification, config);
     },
   };
 }