mattermost-claude-code 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -0,0 +1,241 @@
+# Changelog
+
+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).
+
+## [0.8.1] - 2025-12-28
+
+### Added
+- **`!release-notes` command** - Show release notes for the current version
+- **"What's new" in session header** - Shows a brief summary of new features when starting a session
+
+## [0.8.0] - 2025-12-28
+
+### Added
+- **Image attachment support** - Attach images to your messages and Claude Code will analyze them
+- Supports JPEG, PNG, GIF, and WebP formats
+- Images are downloaded from Mattermost and sent to Claude as base64-encoded content blocks
+- Works for both new sessions and follow-up messages
+- Debug logging shows attached image details (name, type, size)
+
+## [0.7.3] - 2025-12-28
+
+### Fixed
+- Actually fix `!cd` showing "[Exited: null]" - reset flag in async exit handler, not synchronously
+
+## [0.7.2] - 2025-12-28
+
+### Fixed
+- Fix `!cd` command showing "[Exited: null]" message - now properly suppresses exit message during intentional restart
+
+## [0.7.1] - 2025-12-28
+
+### Fixed
+- Fix infinite loop when plan is approved - no longer sends "Continue" message on subsequent ExitPlanMode calls
+
+## [0.7.0] - 2025-12-28
+
+### Added
+- **`!cd <path>` command** - Change working directory mid-session
+- Restarts Claude Code in the new directory with fresh context
+- Session header updates to show current working directory
+- Validates directory exists before switching
+
+## [0.6.1] - 2025-12-28
+
+### Changed
+- Cleaner console output: removed verbose `[Session]` prefixes from logs
+- Debug-only logging for internal session state changes (plan approval, question handling)
+- Consistent emoji formatting for all log messages
+
+## [0.6.0] - 2025-12-28
+
+### Added
+- **Auto-update notifications** - shows banner in session header when new version is available
+- Checks npm registry on startup for latest version
+- Update notice includes install command: `npm install -g mattermost-claude-code`
+
+## [0.5.9] - 2025-12-28
+
+### Fixed
+- Security fix: sanitize bot username in regex to prevent injection
+
+## [0.5.8] - 2025-12-28
+
+### Changed
+- Commands now use `!` prefix instead of `/` to avoid Mattermost slash command conflicts
+- `!help`, `!invite`, `!kick`, `!permissions`, `!stop` replace `/` versions
+- Commands without prefix (`help`, `stop`, `cancel`) still work
+
+## [0.5.7] - 2025-12-28
+
+### Fixed
+- Bot now recognizes mentions with hyphens in username (e.g., `@annes-minion`)
+- Side conversation detection regex updated to handle full Mattermost usernames
+
+## [0.5.6] - 2025-12-28
+
+### Added
+- Timeout warning 5 minutes before session expires
+- Warning message tells user to send a message to keep session alive
+- Warning resets if activity resumes
+
+## [0.5.5] - 2025-12-28
+
+### Added
+- `/help` command to show available session commands
+
+### Changed
+- Replace ASCII diagram with Mermaid flowchart in README
+
+## [0.5.4] - 2025-12-28 (not released)
+
+### Added
+- `/help` command to show available session commands
+
+## [0.5.3] - 2025-12-28
+
+### Added
+- `/permissions interactive` command to enable interactive permissions for a session
+- Can only downgrade permissions (auto → interactive), not upgrade
+- Session header updates to show current permission mode
+
+## [0.5.2] - 2025-12-28
+
+### Changed
+- Complete README rewrite with full documentation of all features
+
+## [0.5.1] - 2025-12-28
+
+### Added
+- `--no-skip-permissions` flag to enable interactive permissions even when `SKIP_PERMISSIONS=true` is set in env
+
+## [0.5.0] - 2025-12-28
+
+### Added
+- **Session collaboration** - invite users to specific sessions without global access
+- **`/invite @username`** - Temporarily allow a user to participate in the current session
+- **`/kick @username`** - Remove an invited user from the current session
+- **Message approval flow** - When unauthorized users send messages in a session thread, the session owner/allowed users can approve via reactions:
+  - 👍 Allow this single message
+  - ✅ Invite them to the session
+  - 👎 Deny the message
+- Per-session allowlist tracked via `sessionAllowedUsers` in each session
+- **Side conversation support** - Messages starting with `@someone-else` are ignored, allowing users to chat without triggering the bot
+- **Dynamic session header** - The session start message updates to show current participants when users are invited or kicked
+
+### Changed
+- Session owner is automatically added to session allowlist
+- Authorization checks now use `isUserAllowedInSession()` for follow-ups
+- Globally allowed users can still access all sessions
+
+## [0.4.0] - 2025-12-28
+
+### Added
+- **CLI arguments** to override all config options (`--url`, `--token`, `--channel`, etc.)
+- **Interactive onboarding** when no `.env` file exists - guided setup with help text
+- Full `--help` output with all available options
+- `--debug` flag to enable verbose logging
+
+### Changed
+- Switched from manual arg parsing to `commander` for better CLI experience
+- Config now supports: CLI args > environment variables > defaults
+
+## [0.3.4] - 2025-12-27
+
+### Added
+- Cancel sessions with `/stop`, `/cancel`, `stop`, or `cancel` commands in thread
+- Cancel sessions by reacting with ❌ or 🛑 to any post in the thread
+
+## [0.3.3] - 2025-12-27
+
+### Added
+- WebSocket heartbeat to detect dead connections after laptop sleep/idle
+- Automatic reconnection when connection goes silent for 60+ seconds
+- Ping every 30 seconds to keep connection alive
+
+### Fixed
+- Connections no longer go "zombie" after laptop sleep - mm-claude now detects and reconnects
+
+## [0.3.2] - 2025-12-27
+
+### Fixed
+- Session card now correctly shows "mm-claude" instead of "Claude Code"
+
+## [0.3.1] - 2025-12-27
+
+### Changed
+- Cleaner console output with colors (verbose logs only shown with `DEBUG=1`)
+- Pimped session start card in Mattermost with version, directory, user, session count, permissions mode, and prompt preview
+- Typing indicator starts immediately when session begins
+- Shortened thread IDs in logs for readability
+
+## [0.3.0] - 2025-12-27
+
+### Added
+- **Multiple concurrent sessions** - each Mattermost thread gets its own Claude CLI process
+- Sessions tracked via `sessions: Map<threadId, Session>` and `postIndex: Map<postId, threadId>`
+- Configurable session limits via `MAX_SESSIONS` env var (default: 5)
+- Automatic idle session cleanup via `SESSION_TIMEOUT_MS` env var (default: 30 min)
+- `killAllSessions()` for graceful shutdown of all sessions
+- Session count logging for monitoring
+
+### Changed
+- `SessionManager` now manages multiple sessions instead of single session
+- `sendFollowUp(threadId, message)` takes threadId parameter
+- `isInSessionThread(threadId)` replaces `isInCurrentSessionThread()`
+- `killSession(threadId)` takes threadId parameter
+
+### Fixed
+- Reaction routing now uses post index lookup for correct session targeting
+
+## [0.2.3] - 2025-12-27
+
+### Added
+- GitHub Actions workflow for automated npm publishing on release
+
+## [0.2.2] - 2025-12-27
+
+### Added
+- Comprehensive `CLAUDE.md` with project documentation for AI assistants
+
+## [0.2.1] - 2025-12-27
+
+### Added
+- `--version` / `-v` flag to display version
+- Version number shown in `--help` output
+
+### Changed
+- Lazy config loading (no .env file needed for --version/--help)
+
+## [0.2.0] - 2025-12-27
+
+### Added
+- Interactive permission approval via Mattermost reactions
+- Permission prompts forwarded to Mattermost thread
+- React with 👍 to allow, ✅ to allow all, or 👎 to deny
+- Only authorized users (ALLOWED_USERS) can approve permissions
+- MCP-based permission server using Claude Code's `--permission-prompt-tool`
+- `SKIP_PERMISSIONS` env var to control permission behavior
+
+### Changed
+- Permissions are now interactive by default (previously skipped)
+- Use `SKIP_PERMISSIONS=true` or `--dangerously-skip-permissions` to skip
+
+## [0.1.0] - 2024-12-27
+
+### Added
+- Initial release
+- Connect Claude Code CLI to Mattermost channels
+- Real-time streaming of Claude responses
+- Interactive plan approval with emoji reactions
+- Sequential question flow with emoji answers
+- Task list display with live updates
+- Code diffs for Edit operations
+- Content preview for Write operations
+- Subagent status tracking
+- Typing indicator while Claude is processing
+- User allowlist for access control
+- Bot mention detection for triggering sessions

package/README.md

@@ -116,6 +116,8 @@ Type `!help` in any session thread to see available commands:
 | Command | Description |
 |:--------|:------------|
 | `!help` | Show available commands |
+| `!release-notes` | Show release notes for current version |
+| `!cd <path>` | Change working directory (restarts Claude) |
 | `!invite @user` | Invite a user to this session |
 | `!kick @user` | Remove an invited user |
 | `!permissions interactive` | Enable interactive permissions |

package/dist/changelog.d.ts

@@ -0,0 +1,20 @@
+interface ReleaseNotes {
+    version: string;
+    date: string;
+    sections: {
+        [key: string]: string[];
+    };
+}
+/**
+ * Parse CHANGELOG.md and extract release notes for a specific version.
+ */
+export declare function getReleaseNotes(version?: string): ReleaseNotes | null;
+/**
+ * Format release notes as a Mattermost message.
+ */
+export declare function formatReleaseNotes(notes: ReleaseNotes): string;
+/**
+ * Get a short summary of what's new (for session header).
+ */
+export declare function getWhatsNewSummary(notes: ReleaseNotes): string;
+export {};

package/dist/changelog.js

@@ -0,0 +1,134 @@
+import { readFileSync, existsSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Parse CHANGELOG.md and extract release notes for a specific version.
+ */
+export function getReleaseNotes(version) {
+    // Try to find CHANGELOG.md in various locations
+    const possiblePaths = [
+        resolve(__dirname, '..', 'CHANGELOG.md'), // dist/../CHANGELOG.md (installed)
+        resolve(__dirname, '..', '..', 'CHANGELOG.md'), // src/../CHANGELOG.md (dev)
+    ];
+    let changelogPath = null;
+    for (const p of possiblePaths) {
+        if (existsSync(p)) {
+            changelogPath = p;
+            break;
+        }
+    }
+    if (!changelogPath) {
+        return null;
+    }
+    try {
+        const content = readFileSync(changelogPath, 'utf-8');
+        return parseChangelog(content, version);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse changelog content and extract notes for a version.
+ * If no version specified, returns the latest (first) version.
+ */
+function parseChangelog(content, targetVersion) {
+    const lines = content.split('\n');
+    let currentVersion = null;
+    let currentDate = null;
+    let currentSection = null;
+    let sections = {};
+    let foundTarget = false;
+    for (const line of lines) {
+        // Match version header: ## [0.8.0] - 2025-12-28
+        const versionMatch = line.match(/^## \[(\d+\.\d+\.\d+)\](?: - (\d{4}-\d{2}-\d{2}))?/);
+        if (versionMatch) {
+            // If we already found our target, we're done
+            if (foundTarget) {
+                break;
+            }
+            currentVersion = versionMatch[1];
+            currentDate = versionMatch[2] || '';
+            sections = {};
+            currentSection = null;
+            // Check if this is the version we want
+            if (!targetVersion || currentVersion === targetVersion) {
+                foundTarget = true;
+            }
+            continue;
+        }
+        // Only process if we're in the target version
+        if (!foundTarget)
+            continue;
+        // Match section header: ### Added, ### Fixed, ### Changed
+        const sectionMatch = line.match(/^### (\w+)/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            sections[currentSection] = [];
+            continue;
+        }
+        // Match list item: - Item text
+        const itemMatch = line.match(/^- (.+)/);
+        if (itemMatch && currentSection) {
+            sections[currentSection].push(itemMatch[1]);
+        }
+    }
+    if (!foundTarget || !currentVersion) {
+        return null;
+    }
+    return {
+        version: currentVersion,
+        date: currentDate || '',
+        sections,
+    };
+}
+/**
+ * Format release notes as a Mattermost message.
+ */
+export function formatReleaseNotes(notes) {
+    let msg = `### 📋 Release Notes - v${notes.version}`;
+    if (notes.date) {
+        msg += ` (${notes.date})`;
+    }
+    msg += '\n\n';
+    for (const [section, items] of Object.entries(notes.sections)) {
+        if (items.length === 0)
+            continue;
+        const emoji = section === 'Added' ? '✨' :
+            section === 'Fixed' ? '🐛' :
+                section === 'Changed' ? '🔄' :
+                    section === 'Removed' ? '🗑️' : '•';
+        msg += `**${emoji} ${section}**\n`;
+        for (const item of items) {
+            msg += `- ${item}\n`;
+        }
+        msg += '\n';
+    }
+    return msg.trim();
+}
+/**
+ * Get a short summary of what's new (for session header).
+ */
+export function getWhatsNewSummary(notes) {
+    const items = [];
+    // Prioritize: Added > Fixed > Changed
+    for (const section of ['Added', 'Fixed', 'Changed']) {
+        const sectionItems = notes.sections[section] || [];
+        for (const item of sectionItems) {
+            // Extract just the first part (before any dash or detail)
+            const short = item.split(' - ')[0].replace(/\*\*/g, '');
+            if (short.length <= 50) {
+                items.push(short);
+            }
+            else {
+                items.push(short.substring(0, 47) + '...');
+            }
+            if (items.length >= 2)
+                break;
+        }
+        if (items.length >= 2)
+            break;
+    }
+    return items.join(', ');
+}

package/dist/claude/session.js

@@ -1,5 +1,6 @@
 import { ClaudeCli } from './cli.js';
 import { getUpdateInfo } from '../update-notifier.js';
+import { getReleaseNotes, getWhatsNewSummary } from '../changelog.js';
 import { readFileSync } from 'fs';
 import { dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
@@ -1010,9 +1011,14 @@ export class SessionManager {
         const updateNotice = updateInfo
             ? `\n> ⚠️ **Update available:** v${updateInfo.current} → v${updateInfo.latest} - Run \`npm install -g mattermost-claude-code\`\n`
             : '';
+        // Get "What's new" from release notes
+        const releaseNotes = getReleaseNotes(pkg.version);
+        const whatsNew = releaseNotes ? getWhatsNewSummary(releaseNotes) : '';
+        const whatsNewLine = whatsNew ? `\n> ✨ **What's new:** ${whatsNew}\n` : '';
         const msg = [
             `### 🤖 mm-claude \`v${pkg.version}\``,
             updateNotice,
+            whatsNewLine,
             `| | |`,
             `|:--|:--|`,
             ...rows,

package/dist/index.js

@@ -8,6 +8,7 @@ import { readFileSync } from 'fs';
 import { dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { checkForUpdates } from './update-notifier.js';
+import { getReleaseNotes, formatReleaseNotes } from './changelog.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'));
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
@@ -101,6 +102,7 @@ async function main() {
                     `| Command | Description |\n` +
                     `|:--------|:------------|\n` +
                     `| \`!help\` | Show this help message |\n` +
+                    `| \`!release-notes\` | Show release notes for current version |\n` +
                     `| \`!cd <path>\` | Change working directory (restarts Claude) |\n` +
                     `| \`!invite @user\` | Invite a user to this session |\n` +
                     `| \`!kick @user\` | Remove an invited user |\n` +
@@ -111,6 +113,17 @@ async function main() {
                     `- ❌ or 🛑 on any message to stop session`, threadRoot);
                 return;
             }
+            // Check for !release-notes command
+            if (lowerContent === '!release-notes' || lowerContent === '!changelog') {
+                const notes = getReleaseNotes(pkg.version);
+                if (notes) {
+                    await mattermost.createPost(formatReleaseNotes(notes), threadRoot);
+                }
+                else {
+                    await mattermost.createPost(`📋 **mm-claude v${pkg.version}**\n\nRelease notes not available. See [GitHub releases](https://github.com/anneschuth/mattermost-claude-code/releases).`, threadRoot);
+                }
+                return;
+            }
             // Check for !invite command
             const inviteMatch = content.match(/^!invite\s+@?([\w.-]+)/i);
             if (inviteMatch) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mattermost-claude-code",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Share Claude Code sessions live in a Mattermost channel with interactive features",
   "main": "dist/index.js",
   "type": "module",
@@ -36,6 +36,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "package.json"
   ],