feat: version system v2.2.0, fix Dockerfile, periodic update checks

- Fix Dockerfile: remove unnecessary Node.js and old CLI install
- Bump deno.json version 1.0.0 -> 2.2.0
- Add BOT_VERSION (read from deno.json) throughout codebase
- Show version + update status in /status command
- Show version in startup embed title
- Add periodic update checks every 12 hours
- Update docs to reflect Dockerfile changes
- CHANGELOG v2.2.0 with all changes documented

Author: zebbern

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2025-07-18
+
+### Added
+- **Version in /status**: Shows bot version (e.g. `v2.2.0`) and update status in the `/status` embed
+- **Periodic Update Checks**: Automatically checks for updates every 12 hours and notifies in Discord
+- **Semver in Startup Embed**: Startup message now shows version number
+- **BOT_VERSION Export**: `deno.json` version read at startup and available throughout codebase
+
+### Changed
+- **Dockerfile Optimized**: Removed unnecessary Node.js and `@anthropic-ai/claude-code` CLI install — bot uses SDK directly via Deno imports, reducing image size
+
+### Fixed
+- `deno.json` version bumped from `1.0.0` to `2.2.0` (was not updated for v2.1.0)
+- CHANGELOG legacy reference to deprecated CLI corrected to `@anthropic-ai/claude-agent-sdk`
+
 ## [2.1.0] - 2025-07-17
 
 ### Added
@@ -169,9 +184,10 @@ This is the first stable release of Claude Code Discord Bot - a Discord bot that
 ### Technical Details
 - Built with Deno 2.x and TypeScript
 - Uses Discord.js 14.14.1
-- Claude API via @anthropic-ai/claude-code (deprecated; see v2.0.0 for migration)
+- Claude API via @anthropic-ai/claude-agent-sdk
 
 ---
 
+[2.2.0]: https://github.com/zebbern/claude-code-discord/releases/tag/v2.2.0
 [2.0.0]: https://github.com/zebbern/claude-code-discord/releases/tag/v2.0.0
 [1.0.0]: https://github.com/zebbern/claude-code-discord/releases/tag/v1.0.0

Dockerfile

@@ -9,17 +9,12 @@ WORKDIR /app
 # Set environment variable to indicate Docker container
 ENV DOCKER_CONTAINER=true
 
-# Install git and Node.js (required for Claude CLI and branch tracking)
+# Install git (required for branch tracking and version checks)
 USER root
 RUN apt-get update && \
-    apt-get install -y git curl && \
-    curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && \
-    apt-get install -y nodejs && \
+    apt-get install -y git && \
     rm -rf /var/lib/apt/lists/*
 
-# Install Claude CLI globally
-RUN npm install -g @anthropic-ai/claude-code
-
 # Create non-root user for security
 RUN groupadd -r claude && useradd -r -g claude claude
 

core/git-shell-handlers.ts

@@ -9,6 +9,7 @@ import type { CommandHandlers, InteractionContext } from "../discord/index.ts";
 import { formatShellOutput, formatGitOutput, formatError, createFormattedEmbed, cleanupPaginationStates } from "../discord/index.ts";
 import type { AllHandlers } from "./handler-registry.ts";
 import type { ProcessCrashHandler, ProcessHealthMonitor } from "../process/index.ts";
+import { BOT_VERSION, getLastCheckResult } from "../util/version-check.ts";
 
 // ================================
 // Types
@@ -549,12 +550,18 @@ export function createUtilityCommandHandlers(
         const gitStatusInfo = await gitHandlers.getStatus();
         const runningCount = shellHandlers.onShellList(ctx).size;
         const worktreeStatus = gitHandlers.onWorktreeBots(ctx);
+        const lastCheck = getLastCheckResult();
+        const updateStatus = lastCheck
+          ? (lastCheck.behind ? `⚠️ Update available (${lastCheck.remoteCommit})` : "✅ Up to date")
+          : "⏳ Checking...";
 
         await ctx.editReply({
           embeds: [{
             color: 0x00ffff,
             title: 'Status',
             fields: [
+              { name: 'Version', value: `v${BOT_VERSION}`, inline: true },
+              { name: 'Updates', value: updateStatus, inline: true },
               { name: 'Claude Code', value: sessionStatus, inline: true },
               { name: 'Git Branch', value: gitStatusInfo.branch, inline: true },
               { name: 'Shell Processes', value: `${runningCount} running`, inline: true },

deno.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "2.2.0",
   "compilerOptions": {
     "lib": ["deno.window"],
     "strict": true

discord/bot.ts

@@ -19,6 +19,7 @@ import { sanitizeChannelName } from "./utils.ts";
 import { handlePaginationInteraction } from "./pagination.ts";
 import { checkCommandPermission } from "../core/rbac.ts";
 import { SETTINGS_ACTIONS, SETTINGS_VALUES } from "../settings/unified-settings.ts";
+import { BOT_VERSION } from "../util/version-check.ts";
 import type { 
   BotConfig, 
   CommandHandlers, 
@@ -513,7 +514,7 @@ export async function createDiscordBot(
       await myChannel.send(convertMessageContent({
         embeds: [{
           color: 0x00ff00,
-          title: '🚀 Startup Complete',
+          title: `🚀 v${BOT_VERSION} — Startup Complete`,
           description: `Claude Code bot for branch ${branchName} has started`,
           fields: [
             { name: 'Category', value: actualCategoryName, inline: true },

docs/docker.md

@@ -82,8 +82,7 @@ This checks for new images every 5 minutes and restarts the bot automatically.
 
 The Dockerfile builds on `denoland/deno:latest` and adds:
 
-- **Node.js 20** (required for Claude CLI)
-- **`@anthropic-ai/claude-code`** CLI (installed globally via npm)
+- **Git** (required for branch tracking and version checks)
 - **Deno cached dependencies** from `deno.json`
 
 ## Resource Limits

docs/installation.md

@@ -146,5 +146,5 @@ Environment variables override `.env` file settings. CLI flags override environm
 ### Docker (all platforms)
 
 - Docker Desktop required on Windows/macOS, Docker Engine on Linux
-- The image bundles Deno, Node.js, and Claude CLI so no local installs needed
+- The image bundles Deno and Git so no local installs needed
 - See [Docker Guide](docker.md) for volumes, GHCR, and Watchtower

index.ts

@@ -33,7 +33,7 @@ import { systemCommands } from "./system/index.ts";
 import { helpCommand } from "./help/index.ts";
 import { agentCommand } from "./agent/index.ts";
 import { cleanupPaginationStates } from "./discord/index.ts";
-import { runVersionCheck } from "./util/version-check.ts";
+import { runVersionCheck, startPeriodicUpdateCheck, BOT_VERSION } from "./util/version-check.ts";
 
 // Core modules - now handle most of the heavy lifting
 import { 
@@ -248,6 +248,34 @@ export async function createClaudeCodeBot(config: BotConfig) {
       }
     }
   }).catch(() => { /* version check is best-effort */ });
+
+  // Start periodic update checks (every 12 hours)
+  startPeriodicUpdateCheck(async (result) => {
+    try {
+      const channel = bot.getChannel();
+      if (channel) {
+        const { EmbedBuilder } = await import("npm:discord.js@14.14.1");
+        const embed = new EmbedBuilder()
+          .setColor(0xFFA500)
+          .setTitle("🔄 Update Available")
+          .setDescription(`A newer version is available. You are running **v${BOT_VERSION}** (\`${result.localCommit}\`).`)
+          .addFields(
+            { name: "Latest Commit", value: `\`${result.remoteCommit}\``, inline: true },
+            {
+              name: "How to Update",
+              value: Deno.env.get("DOCKER_CONTAINER")
+                ? "```\ndocker compose pull && docker compose up -d\n```"
+                : "```\ngit pull origin main && deno task start\n```",
+              inline: false
+            }
+          )
+          .setTimestamp();
+        await channel.send({ embeds: [embed] });
+      }
+    } catch {
+      // Periodic notification is best-effort
+    }
+  });
 
   // Setup signal handlers for graceful shutdown
   setupSignalHandlers({

util/version-check.ts

@@ -1,14 +1,21 @@
 /**
  * Version checker - compares local commit hash against GitHub's latest.
  * Notifies at startup if the bot is behind.
+ * Also provides periodic update checks and semver display.
  *
  * @module util/version-check
  */
 
+// Read version from deno.json at startup
+const denoConfig = JSON.parse(Deno.readTextFileSync("deno.json"));
+
+/** Current bot version from deno.json */
+export const BOT_VERSION: string = denoConfig.version ?? "unknown";
+
 const REPO_OWNER = "zebbern";
 const REPO_NAME = "claude-code-discord";
 
-interface VersionCheckResult {
+export interface VersionCheckResult {
   upToDate: boolean;
   localCommit: string;
   remoteCommit: string;
@@ -109,10 +116,10 @@ export async function runVersionCheck(): Promise<{
     embed: {
       color: 0xFFA500, // Orange
       title: "Update Available",
-      description: "A newer version of claude-code-discord is available on GitHub.",
+      description: `A newer version of claude-code-discord is available on GitHub. You are running **v${BOT_VERSION}**.`,
       fields: [
-        { name: "Your Version", value: `\`${result.localCommit}\``, inline: true },
-        { name: "Latest Version", value: `\`${result.remoteCommit}\``, inline: true },
+        { name: "Your Commit", value: `\`${result.localCommit}\``, inline: true },
+        { name: "Latest Commit", value: `\`${result.remoteCommit}\``, inline: true },
         {
           name: "How to Update",
           value: Deno.env.get("DOCKER_CONTAINER")
@@ -124,3 +131,38 @@ export async function runVersionCheck(): Promise<{
     },
   };
 }
+
+/** Cached update check result for use in /status and periodic checks */
+let lastCheckResult: VersionCheckResult | null = null;
+
+/** Get cached update status (non-blocking, returns last known state) */
+export function getLastCheckResult(): VersionCheckResult | null {
+  return lastCheckResult;
+}
+
+/**
+ * Start periodic update checks.
+ * Runs checkForUpdates every `intervalMs` (default: 12 hours).
+ * Calls `onUpdateAvailable` when an update is detected.
+ */
+export function startPeriodicUpdateCheck(
+  onUpdateAvailable: (result: VersionCheckResult) => void,
+  intervalMs = 12 * 60 * 60 * 1000
+): number {
+  const check = async () => {
+    try {
+      const result = await checkForUpdates();
+      lastCheckResult = result;
+      if (result.behind) {
+        onUpdateAvailable(result);
+      }
+    } catch {
+      // Silently ignore periodic check failures
+    }
+  };
+
+  // Run initial check to populate cache
+  check();
+
+  return setInterval(check, intervalMs) as unknown as number;
+}