alvin-bot 4.16.0 → 4.16.1

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to Alvin Bot are documented here.
 
+## [4.16.1] — 2026-04-20
+
+### 🆕 Feature: /update shows release highlights
+
+After a successful `/update`, the bot now sends a second short message with a bullet-point summary of what actually changed in the newly installed version. Pulled from the CHANGELOG entry matching the version string in the update result.
+
+**Implementation:**
+- New module `src/services/release-highlights.ts` parses the CHANGELOG block for a given version and returns at most 5 bullet points, ≤500 chars total.
+- Strategy: prefer `### ` subsection headlines (feature/fix titles); fall back to first non-empty paragraph lines.
+- Telegram-friendly output: plain bullets (`• ...`), no tables, no code blocks, truncates gracefully with an ellipsis line if too long.
+
+**Result format in chat:**
+```
+✅ Installed v4.16.1 (was v4.16.0). Restarting...
+📝 What's new in v4.16.1
+
+• Feature: /update shows release highlights
+```
+
 ## [4.16.0] — 2026-04-20
 
 ### 🚀 Feature: bot-owned CDP Chromium — no more hub dependency

package/dist/handlers/commands.js

@@ -27,6 +27,7 @@ import { BOT_VERSION } from "../version.js";
 import { getWebPort } from "../web/server.js";
 import { getUsageSummary, getAllRateLimits, formatTokens } from "../services/usage-tracker.js";
 import { runUpdate, getAutoUpdate, setAutoUpdate, startAutoUpdateLoop } from "../services/updater.js";
+import { getReleaseHighlights } from "../services/release-highlights.js";
 import { getHealthStatus, isFailedOver } from "../services/heartbeat.js";
 import { t, LOCALE_NAMES, LOCALE_FLAGS } from "../i18n.js";
 // Kick off auto-update loop on module load if the persistent flag is set.
@@ -1875,6 +1876,17 @@ export function registerCommands(bot) {
             const result = await runUpdate();
             if (result.ok) {
                 await ctx.reply(`✅ ${result.message}`);
+                // Extract the installed version from the message (e.g. "Installed v4.16.1 ...")
+                // so we can look up its CHANGELOG block. Falls silently if no match.
+                const versionMatch = result.message.match(/v(\d+\.\d+\.\d+)/);
+                if (versionMatch) {
+                    const highlights = getReleaseHighlights(versionMatch[1]);
+                    if (highlights) {
+                        await ctx.reply(`📝 *What's new in v${versionMatch[1]}*\n\n${highlights}`, {
+                            parse_mode: "Markdown",
+                        });
+                    }
+                }
                 if (result.requiresRestart) {
                     await ctx.reply(t("bot.update.restarting", lang));
                     setTimeout(() => process.exit(0), 500);

package/dist/services/release-highlights.js

@@ -0,0 +1,79 @@
+/**
+ * Release Highlights — extract a short human-readable summary for a given
+ * version from CHANGELOG.md.
+ *
+ * Used by the /update command to tell users what actually changed after a
+ * successful upgrade. Deliberately short — Telegram-friendly (<500 chars),
+ * headline + up to 5 bullets, no markdown tables, no code blocks.
+ */
+import fs from "fs";
+import path from "path";
+import { BOT_ROOT } from "../paths.js";
+const CHANGELOG_PATH = path.resolve(BOT_ROOT, "CHANGELOG.md");
+const MAX_BULLETS = 5;
+const MAX_CHARS = 500;
+/**
+ * Find the block for `## [<version>]` in CHANGELOG.md and return a
+ * compact summary (headline + a few bullet points). Returns null if the
+ * version block is not found or CHANGELOG.md is missing.
+ */
+export function getReleaseHighlights(version) {
+    let content;
+    try {
+        content = fs.readFileSync(CHANGELOG_PATH, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const versionEscaped = version.replace(/\./g, "\\.");
+    // Match from "## [X.Y.Z]" up to the next "## [" (or end of file)
+    const blockRe = new RegExp(`^##\\s*\\[${versionEscaped}\\][^\\n]*\\n([\\s\\S]*?)(?=^##\\s*\\[|\\Z)`, "m");
+    const match = content.match(blockRe);
+    if (!match)
+        return null;
+    return compactHighlights(match[1]);
+}
+/**
+ * Extract up to MAX_BULLETS short lines from a CHANGELOG block.
+ * Strategy:
+ *   1. Prefer "### " subsection headlines (feature/fix titles)
+ *   2. Otherwise the first few non-empty lines of the first paragraph
+ * Truncate to MAX_CHARS total so it fits comfortably in a Telegram message.
+ */
+function compactHighlights(block) {
+    const lines = block.split("\n");
+    const headlines = [];
+    for (const line of lines) {
+        const m = line.match(/^###\s+(.+?)\s*$/);
+        if (!m)
+            continue;
+        // Strip leading emoji/punctuation like "🚀 Feature: ..."
+        const title = m[1].replace(/^[^a-zA-Z0-9]+/, "").replace(/\s+/g, " ").trim();
+        if (title)
+            headlines.push(title);
+    }
+    let bullets;
+    if (headlines.length > 0) {
+        bullets = headlines.slice(0, MAX_BULLETS);
+    }
+    else {
+        // Fallback: grab the first non-empty lines (skip bold marker paragraphs,
+        // keep narrative). Limit to MAX_BULLETS lines.
+        const flat = lines
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && !l.startsWith("```") && !l.startsWith("|"));
+        bullets = flat.slice(0, MAX_BULLETS);
+    }
+    const rendered = bullets.map((b) => `• ${b}`).join("\n");
+    if (rendered.length <= MAX_CHARS)
+        return rendered;
+    // Trim to fit — add a soft ellipsis on a whole line
+    let out = "";
+    for (const b of bullets) {
+        const next = out ? out + "\n• " + b : "• " + b;
+        if (next.length > MAX_CHARS - 4)
+            break;
+        out = next;
+    }
+    return out + "\n…";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alvin-bot",
-  "version": "4.16.0",
+  "version": "4.16.1",
   "description": "Alvin Bot \u2014 Your personal AI agent on Telegram, WhatsApp, Discord, Signal, and Web.",
   "type": "module",
   "main": "dist/index.js",