updated docs site to include new slackbot ai summary feature

Author: barrymichaeldoyle

package.json

@@ -9,7 +9,7 @@
   "engines": {
     "node": ">=22"
   },
-  "packageManager": "pnpm@10.30.3",
+  "packageManager": "pnpm@10.33.0",
   "devDependencies": {
     "@changesets/cli": "^2.30.0",
     "@types/node": "25.6.0",

packages/docs/package.json

@@ -10,6 +10,6 @@
   },
   "dependencies": {
     "@astrojs/starlight": "^0.38.3",
-    "astro": "^6.1.5"
+    "astro": "^6.1.6"
   }
 }

packages/docs/src/content/docs/index.mdx

@@ -27,7 +27,7 @@ import { CardGrid, LinkCard } from '@astrojs/starlight/components';
   <LinkCard
     title="Slack Bot"
     href="./slack-bot"
-    description="Get update notifications in Slack when tracked packages release new versions."
+    description="Get Slack release alerts with GitHub release links and AI-generated summaries for tracked packages."
   />
   <LinkCard
     title="VS Code Extension"

packages/docs/src/content/docs/introduction.mdx

@@ -11,7 +11,7 @@ Patch Pulse is a suite of tools that help you keep your npm dependencies up to d
 | --------------------------------------- | ---------------------------------------------------------------------------- |
 | [CLI](../cli/overview)                  | Zero-dependency command-line tool to scan your project for outdated packages |
 | [VS Code Extension](../vscode/overview) | Inline version information directly in your `package.json` files             |
-| [Slack Bot](../slack-bot)               | Get notified in Slack when packages you depend on release new versions       |
+| [Slack Bot](../slack-bot)               | Get Slack release alerts with GitHub release links and AI summaries          |
 
 ## Core concepts
 

packages/docs/src/content/docs/slack-bot.mdx

@@ -1,11 +1,11 @@
 ---
 title: Slack Bot
-description: Get notified in Slack when packages you depend on release new versions.
+description: Get Slack notifications for new package releases, plus GitHub release links and AI summaries.
 ---
 
 import { Aside } from '@astrojs/starlight/components';
 
-The Patch Pulse Slack Bot notifies your workspace whenever a package you depend on releases a new version — so your team stays informed without having to run the CLI manually.
+The Patch Pulse Slack Bot notifies your workspace whenever a package you depend on releases a new version, updates the message with GitHub release links when they are available, and posts an AI-generated summary in the thread when the release evidence is strong enough.
 
 <a
   href="https://grand-yak-92.convex.site/slack/install"
@@ -28,3 +28,10 @@ The Patch Pulse Slack Bot notifies your workspace whenever a package you depend
 ## How it works
 
 Once installed, the bot monitors packages you care about and sends a Slack notification when a new version is published to the npm registry.
+
+For supported releases, Patch Pulse also enriches that notification after the initial post:
+
+- it adds GitHub release links when repository metadata can be resolved
+- it posts a short AI-generated thread summary of what changed when upstream release evidence is strong enough
+
+That gives your team the version bump, the release source, and a quick readable summary without leaving Slack.

packages/notifier-bot/convex/packages.ts

@@ -60,14 +60,18 @@ export const ensureExists = internalMutation({
     name: v.string(),
     version: v.string(),
     ecosystem: v.optional(v.string()),
+    githubRepoUrl: v.optional(v.string()),
   },
-  handler: async (ctx, { name, version, ecosystem }) => {
+  handler: async (ctx, { name, version, ecosystem, githubRepoUrl }) => {
     const existing = await ctx.db
       .query('packages')
       .withIndex('by_name', (q) => q.eq('name', name))
       .first();
 
     if (existing) {
+      if (githubRepoUrl && existing.githubRepoUrl !== githubRepoUrl) {
+        await ctx.db.patch(existing._id, { githubRepoUrl });
+      }
       return { packageId: existing._id, dbVersion: existing.currentVersion };
     }
 
@@ -76,6 +80,7 @@ export const ensureExists = internalMutation({
       currentVersion: version,
       ecosystem: ecosystem ?? 'npm',
       lastChecked: Date.now(),
+      githubRepoUrl,
     });
 
     return { packageId, dbVersion: version };

packages/notifier-bot/convex/slack.commands.test.ts

@@ -19,11 +19,13 @@ function createFetchMock(
   responseMessages: string[],
   options?: {
     npmVersions?: Record<string, string>;
+    npmRepositories?: Record<string, string | null>;
     postedMessages?: Array<{ channel: string; text: string }>;
     publishedViews?: Array<{ userId: string; blocks: unknown[] }>;
     channelNames?: Record<string, string>;
     channelIdsByName?: Record<string, string>;
     conversationsListError?: string;
+    githubReleaseUrlsByTag?: Record<string, string>;
   },
 ) {
   return vi.fn(async (input: string | URL | Request, init?: RequestInit) => {
@@ -43,13 +45,24 @@ function createFetchMock(
         return jsonResponse({ error: 'not_found' }, 404);
       }
 
+      const repository = options?.npmRepositories?.[packageName];
       return jsonResponse({
         'dist-tags': { latest: version },
-        repository: 'github:facebook/react',
+        ...(repository ? { repository } : {}),
         versions: { [version]: {} },
       });
     }
 
+    if (url.startsWith('https://api.github.com/repos/')) {
+      const match = url.match(/\/releases\/tags\/([^/?#]+)$/);
+      const tag = match ? decodeURIComponent(match[1]) : '';
+      const htmlUrl = tag ? options?.githubReleaseUrlsByTag?.[tag] : undefined;
+      if (!htmlUrl) {
+        return jsonResponse({ message: 'Not Found' }, 404);
+      }
+      return jsonResponse({ html_url: htmlUrl });
+    }
+
     if (url === 'https://slack.com/api/chat.postMessage') {
       const raw = typeof init?.body === 'string' ? init.body : '';
       const body = JSON.parse(raw);
@@ -390,6 +403,63 @@ describe('Slack multi-channel subscriptions', () => {
     expect(responseMessages).toEqual([]);
   });
 
+  it('links the tracked current version to the exact GitHub release tag when available', async () => {
+    const postedMessages: Array<{ channel: string; text: string }> = [];
+    vi.stubGlobal(
+      'fetch',
+      createFetchMock([], {
+        postedMessages,
+        npmVersions: { react: '19.0.0' },
+        npmRepositories: { react: 'github:facebook/react' },
+        githubReleaseUrlsByTag: {
+          'v19.0.0': 'https://github.com/facebook/react/releases/tag/v19.0.0',
+        },
+      }),
+    );
+
+    const t = convexTest(schema, modules);
+    await seedWorkspace(t);
+
+    await t.action(internal.slack.commands.processNpmTrack, {
+      packageName: 'react',
+      teamId: TEAM_ID,
+      minUpdateType: 'patch',
+      userId: 'U_ALICE',
+    });
+
+    expect(postedMessages).toHaveLength(1);
+    expect(postedMessages[0].text).toContain(
+      'current version <https://github.com/facebook/react/releases/tag/v19.0.0|19.0.0>',
+    );
+  });
+
+  it('falls back to the repo releases page when tracking cannot resolve an exact release tag', async () => {
+    const postedMessages: Array<{ channel: string; text: string }> = [];
+    vi.stubGlobal(
+      'fetch',
+      createFetchMock([], {
+        postedMessages,
+        npmVersions: { react: '19.0.0' },
+        npmRepositories: { react: 'github:facebook/react' },
+      }),
+    );
+
+    const t = convexTest(schema, modules);
+    await seedWorkspace(t);
+
+    await t.action(internal.slack.commands.processNpmTrack, {
+      packageName: 'react',
+      teamId: TEAM_ID,
+      minUpdateType: 'patch',
+      userId: 'U_ALICE',
+    });
+
+    expect(postedMessages).toHaveLength(1);
+    expect(postedMessages[0].text).toContain(
+      'current version <https://github.com/facebook/react/releases|19.0.0>',
+    );
+  });
+
   it('resolves a typed channel name to a Slack channel ID before posting and storing', async () => {
     const responseMessages: string[] = [];
     const postedMessages: Array<{ channel: string; text: string }> = [];
@@ -574,7 +644,12 @@ describe('Slack multi-channel subscriptions', () => {
 
   it('stores github repo metadata during polling so list can use it later', async () => {
     const responseMessages: string[] = [];
-    vi.stubGlobal('fetch', createFetchMock(responseMessages));
+    vi.stubGlobal(
+      'fetch',
+      createFetchMock(responseMessages, {
+        npmRepositories: { react: 'github:facebook/react' },
+      }),
+    );
 
     const t = convexTest(schema, modules);
     const subscriberId = await seedWorkspace(t);

packages/notifier-bot/convex/slack/commands.ts

@@ -1,9 +1,18 @@
 import { v } from 'convex/values';
-import { fetchNpmLatestVersion, isVersionOutdated } from '@patch-pulse/shared';
+import {
+  fetchNpmPackageManifest,
+  getNpmLatestVersion,
+  isVersionOutdated,
+} from '@patch-pulse/shared';
 import { ActionCtx, httpAction, internalAction } from '../_generated/server';
 import { internal } from '../_generated/api';
 import { Id } from '../_generated/dataModel';
-import { formatSlackPackageLink, formatSlackVersionText } from './links';
+import {
+  extractGitHubRepoUrl,
+  formatSlackPackageLink,
+  formatSlackVersionText,
+  resolveSlackVersionText,
+} from './links';
 import {
   chatPostMessage,
   conversationsFindByName,
@@ -33,31 +42,31 @@ function formatPackageName(packageName: string): string {
   return `\`${packageName}\``;
 }
 
-function formatVersion(version: string): string {
-  return `\`${version}\``;
-}
-
 type TrackOutcome =
   | {
       kind: 'tracked';
       packageId: Id<'packages'>;
       packageName: string;
       version: string;
       displayVersion: string;
+      versionText: string;
+      displayVersionText: string;
       filterLabel: string | null;
       pendingUpdate: boolean;
     }
   | {
       kind: 'updated';
       packageName: string;
       version: string;
+      versionText: string;
       filterLabel: string | null;
       channelName?: string;
     }
   | {
       kind: 'already';
       packageName: string;
       version: string;
+      versionText: string;
       filterLabel: string | null;
       channelName?: string;
     }
@@ -86,20 +95,24 @@ async function trackPackage(
 ): Promise<TrackOutcome> {
   packageName = normalizeNpmPackageName(packageName);
 
-  const version = await fetchNpmLatestVersion(packageName, {
+  const manifest = await fetchNpmPackageManifest(packageName, {
     userAgent: 'patch-pulse-notifier-bot',
   }).catch(() => null);
+  const version = getNpmLatestVersion(manifest);
 
   if (!version) {
     return { kind: 'not_found', packageName };
   }
 
+  const githubRepoUrl = manifest ? extractGitHubRepoUrl(manifest) : undefined;
+
   const { packageId, dbVersion } = await ctx.runMutation(
     internal.packages.ensureExists,
     {
       name: packageName,
       version,
       ecosystem: 'npm',
+      githubRepoUrl,
     },
   );
 
@@ -124,6 +137,11 @@ async function trackPackage(
         kind: 'updated',
         packageName,
         version,
+        versionText: await resolveSlackVersionText(
+          version,
+          manifest,
+          githubRepoUrl,
+        ),
         filterLabel: formatMinUpdateType(minUpdateType),
         channelName: existing.channelName,
       };
@@ -133,6 +151,11 @@ async function trackPackage(
       kind: 'already',
       packageName,
       version,
+      versionText: await resolveSlackVersionText(
+        version,
+        manifest,
+        githubRepoUrl,
+      ),
       filterLabel: formatMinUpdateType(existing.minUpdateType as MinUpdateType),
       channelName: existing.channelName,
     };
@@ -148,12 +171,24 @@ async function trackPackage(
     userId: channelId ? undefined : userId,
   });
 
+  const displayVersion = pendingUpdate ? dbVersion : version;
+
   return {
     kind: 'tracked',
     packageId,
     packageName,
     version,
-    displayVersion: pendingUpdate ? dbVersion : version,
+    displayVersion,
+    versionText: await resolveSlackVersionText(
+      version,
+      manifest,
+      githubRepoUrl,
+    ),
+    displayVersionText: await resolveSlackVersionText(
+      displayVersion,
+      manifest,
+      githubRepoUrl,
+    ),
     filterLabel: formatMinUpdateType(minUpdateType),
     pendingUpdate,
   };
@@ -162,11 +197,11 @@ async function trackPackage(
 function formatTrackOutcomeLine(outcome: TrackOutcome): string {
   switch (outcome.kind) {
     case 'tracked':
-      return `• ${formatSlackPackageLink(outcome.packageName)} — current version ${formatVersion(outcome.displayVersion)}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}${outcome.pendingUpdate ? ` (update available: ${formatVersion(outcome.version)})` : ''}`;
+      return `• ${formatSlackPackageLink(outcome.packageName)} — current version ${outcome.displayVersionText}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}${outcome.pendingUpdate ? ` (update available: ${outcome.versionText})` : ''}`;
     case 'updated':
-      return `• ${formatSlackPackageLink(outcome.packageName)} — updated threshold to ${outcome.filterLabel ?? 'all'} notifications, current version ${formatVersion(outcome.version)}`;
+      return `• ${formatSlackPackageLink(outcome.packageName)} — updated threshold to ${outcome.filterLabel ?? 'all'} notifications, current version ${outcome.versionText}`;
     case 'already':
-      return `• ${formatSlackPackageLink(outcome.packageName)} — already tracked at ${formatVersion(outcome.version)}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}`;
+      return `• ${formatSlackPackageLink(outcome.packageName)} — already tracked at ${outcome.versionText}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}`;
     case 'not_found':
       return `• ${formatPackageName(outcome.packageName)} — not found on npm`;
   }
@@ -593,7 +628,7 @@ export const processNpmTrack = internalAction({
       const channelLabel = formatChannelPhrase(outcome.channelName);
       await sendFeedback(
         details,
-        `Updated: now tracking ${formatSlackPackageLink(packageName)}${channelLabel} with ${outcome.filterLabel ?? 'all'} notifications — currently at ${formatVersion(outcome.version)}`,
+        `Updated: now tracking ${formatSlackPackageLink(packageName)}${channelLabel} with ${outcome.filterLabel ?? 'all'} notifications — currently at ${outcome.versionText}`,
       );
       if (!responseUrl && userId) {
         await ctx.scheduler.runAfter(
@@ -609,7 +644,7 @@ export const processNpmTrack = internalAction({
       const channelLabel = formatChannelPhrase(outcome.channelName);
       await sendFeedback(
         details,
-        `Already tracking ${formatSlackPackageLink(packageName)} — currently at ${formatVersion(outcome.version)}${channelLabel}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}`,
+        `Already tracking ${formatSlackPackageLink(packageName)} — currently at ${outcome.versionText}${channelLabel}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}`,
       );
       if (!responseUrl && userId) {
         await ctx.scheduler.runAfter(
@@ -623,7 +658,7 @@ export const processNpmTrack = internalAction({
 
     if (details) {
       const updateSuffix = outcome.pendingUpdate
-        ? ` There's already an update available (${formatVersion(outcome.displayVersion)} → ${formatVersion(outcome.version)}) — I'll notify you about it shortly.`
+        ? ` There's already an update available (${outcome.displayVersionText} → ${outcome.versionText}) — I'll notify you about it shortly.`
         : '';
 
       if (channelId) {
@@ -632,7 +667,7 @@ export const processNpmTrack = internalAction({
           await chatPostMessage(
             details.accessToken,
             channelId,
-            `<@${userId}> is now tracking ${formatSlackPackageLink(packageName)} in this channel — current version ${formatVersion(outcome.displayVersion)}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}${updateSuffix}`,
+            `<@${userId}> is now tracking ${formatSlackPackageLink(packageName)} in this channel — current version ${outcome.displayVersionText}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}${updateSuffix}`,
           );
         } catch (error) {
           if (error instanceof PrivateChannelError) {
@@ -654,7 +689,7 @@ export const processNpmTrack = internalAction({
         await chatPostMessage(
           details.accessToken,
           userId,
-          `You're now tracking ${formatSlackPackageLink(packageName)} — current version ${formatVersion(outcome.displayVersion)}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}.${updateSuffix || " I'll DM you when updates are available."}`,
+          `You're now tracking ${formatSlackPackageLink(packageName)} — current version ${outcome.displayVersionText}${outcome.filterLabel ? ` ${outcome.filterLabel}` : ''}.${updateSuffix || " I'll DM you when updates are available."}`,
         );
       }
     }