@goodnesshq/opencode-notification 0.1.7 → 0.2.0

package/.opencode/notify-init.mjs

@@ -21,10 +21,10 @@ const DEFAULTS = {
   enabled: true,
   title: "",
   tier: "focus",
-  detailLevel: "full",
+  detailLevel: "title-only",
   responseComplete: {
     enabled: true,
-    trigger: "message.updated",
+    trigger: "session.idle",
   },
   channels: {
     mac: {
@@ -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 === "backspace") {
-            if (filter.length > 0) {
+          if (key.name === "return" || key.name === "enter") {
+            finish();
+            return;
+          }
+          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() {
@@ -492,18 +524,18 @@ async function main() {
             value: "message.part.updated",
           },
         ],
-        defaultValue: "message.updated",
+        defaultValue: "session.idle",
       })
     : await (async () => {
         console.log(
           "\nResponse-complete trigger:\n  1) session.idle (coarse, low noise)\n  2) message.updated (precise)\n  3) message.part.updated (very precise, more noise)",
         );
-        const triggerInput = await rl.question("> [2] ");
-        return triggerInput.trim() === "1"
-          ? "session.idle"
+        const triggerInput = await rl.question("> [1] ");
+        return triggerInput.trim() === "2"
+          ? "message.updated"
           : triggerInput.trim() === "3"
             ? "message.part.updated"
-            : "message.updated";
+            : "session.idle";
       })();
 
   const macEnabled = interactive
@@ -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,17 @@ 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: ");
+    const chatIdInput = interactive
+      ? await promptInput("Telegram chat ID (see docs/telegram-chat-id.md): ")
+      : await rl.question("Telegram chat ID (see docs/telegram-chat-id.md): ");
+    telegramToken = tokenInput.trim();
+    telegramChatId = chatIdInput.trim();
+  }
+
   const detailLevel = interactive
     ? await promptSelect({
         message: "Detail level:",
@@ -551,11 +601,11 @@ async function main() {
           { name: "full", value: "full" },
           { name: "title-only", value: "title-only" },
         ],
-        defaultValue: "full",
+        defaultValue: "title-only",
       })
-    : (await rl.question("Detail level (1=full, 2=title-only) [1] ")).trim() === "2"
-      ? "title-only"
-      : "full";
+    : (await rl.question("Detail level (1=full, 2=title-only) [2] ")).trim() === "1"
+      ? "full"
+      : "title-only";
 
   const adjustGroups = interactive
     ? await promptConfirm("Adjust event groups?", false)
@@ -607,20 +657,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 +699,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 +723,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
@@ -34,8 +35,8 @@ The config is defined in `.opencode/oc-notify.schema.json` and supports:
 - `title`: override or template (supports `{repo}` and `{branch}`)
 - `tier`: `focus` | `full` | `custom`
 - `detailLevel`: `full` | `title-only`
-- `responseComplete`: trigger for completion notifications
-- `channels`: `mac` and `ntfy` settings
+- `responseComplete`: trigger for completion notifications (default: `session.idle`)
+- `channels`: `mac`, `ntfy`, and `telegram` settings
 - `overrides`: include/exclude groups
 - `dedupe`: in-memory TTL settings
 
@@ -51,13 +52,15 @@ The config is defined in `.opencode/oc-notify.schema.json` and supports:
 {
   "enabled": true,
   "tier": "focus",
+  "detailLevel": "title-only",
   "responseComplete": {
     "enabled": true,
     "trigger": "session.idle"
   },
   "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": "" }
   }
 }
 ```
@@ -67,10 +70,10 @@ The config is defined in `.opencode/oc-notify.schema.json` and supports:
 {
   "enabled": true,
   "tier": "full",
-  "detailLevel": "full",
+  "detailLevel": "title-only",
   "responseComplete": {
     "enabled": true,
-    "trigger": "message.updated"
+    "trigger": "session.idle"
   }
 }
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodnesshq/opencode-notification",
-  "version": "0.1.7",
-  "description": "Per-repo notification plugin for OpenCode with macOS and ntfy delivery.",
+  "version": "0.2.0",
+  "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

@@ -11,10 +11,10 @@ const DEFAULTS = {
   enabled: true,
   title: "",
   tier: "focus",
-  detailLevel: "full",
+  detailLevel: "title-only",
   responseComplete: {
     enabled: true,
-    trigger: "message.updated",
+    trigger: "session.idle",
   },
   channels: {
     mac: {
@@ -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);
     },
   };
 }