instar 0.24.18 → 0.24.21

package/upgrades/0.24.18-beta.0.md

@@ -0,0 +1,35 @@
+# v0.24.18-beta.0 — Slack Messaging Adapter (Beta)
+
+## What Changed
+
+Native Slack support joins Telegram and WhatsApp as a first-class messaging adapter. Your agent can now live in Slack — receiving messages via Socket Mode, responding in channels, and managing conversations with the same features Telegram has.
+
+This is a beta release for early testing. The core adapter is complete and working, with setup wizard support, session management, and feature parity across most Telegram capabilities.
+
+## What to Tell Your User
+
+Your agent can now talk to you through Slack. If you already use Slack for work, you can add it alongside Telegram — no need to switch. Setup takes about 5 minutes: you log into Slack, and the agent handles creating the workspace, app, and channels automatically.
+
+Slack sessions show up in the dashboard with their own platform badge, and you can create new sessions linked to Slack channels right from the dashboard. Commands work with an exclamation mark prefix — type !sessions or !new in any channel the agent is in.
+
+This also includes a new autonomous mode skill that lets the agent work independently for hours with structural enforcement — it literally cannot stop until the work is done.
+
+## Summary of New Capabilities
+
+- Slack messaging adapter with Socket Mode (real-time WebSocket, no webhooks needed)
+- DIY app model — each user creates their own Slack app, no shared infrastructure
+- Browser-automated setup wizard (Playwright drives workspace creation, app config, token extraction)
+- Session channel registry with bidirectional channel-to-session mapping
+- Channel resume map for conversation continuity across session restarts
+- Attention channel for critical alerts (auto-created, users auto-invited)
+- Dashboard link broadcast to Slack dashboard channel (update-in-place, no spam)
+- Slash commands via ! prefix (!sessions, !new, !help)
+- Platform badges on dashboard session cards
+- Platform dropdown when creating new sessions
+- Job scheduler integration (per-job Slack channels)
+- Cross-platform alerts (Slack added alongside Telegram and WhatsApp)
+- Presence proxy routing to correct session channels
+- SlackLifeline process for persistent Socket Mode connection
+- Autonomous mode skill with stop hook enforcement and session isolation
+- Unanswered message detection in Slack context hook
+- Message logging, search, and retention for Slack

package/upgrades/0.24.18.md

@@ -1,35 +1,35 @@
-# v0.24.18-beta.0 — Slack Messaging Adapter (Beta)
+# Upgrade Guide — vNEXT
 
-## What Changed
+<!-- bump: patch -->
+<!-- Valid values: patch, minor, major -->
+<!-- patch = bug fixes, refactors, test additions, doc updates -->
+<!-- minor = new features, new APIs, new capabilities (backwards-compatible) -->
+<!-- major = breaking changes to existing APIs or behavior -->
 
-Native Slack support joins Telegram and WhatsApp as a first-class messaging adapter. Your agent can now live in Slack — receiving messages via Socket Mode, responding in channels, and managing conversations with the same features Telegram has.
+## What Changed
 
-This is a beta release for early testing. The core adapter is complete and working, with setup wizard support, session management, and feature parity across most Telegram capabilities.
+<!-- Describe what changed technically. What new features, APIs, behavioral changes? -->
+<!-- Write this for the AGENT — they need to understand the system deeply. -->
 
 ## What to Tell Your User
 
-Your agent can now talk to you through Slack. If you already use Slack for work, you can add it alongside Telegram — no need to switch. Setup takes about 5 minutes: you log into Slack, and the agent handles creating the workspace, app, and channels automatically.
-
-Slack sessions show up in the dashboard with their own platform badge, and you can create new sessions linked to Slack channels right from the dashboard. Commands work with an exclamation mark prefix — type !sessions or !new in any channel the agent is in.
-
-This also includes a new autonomous mode skill that lets the agent work independently for hours with structural enforcement — it literally cannot stop until the work is done.
+<!-- Write talking points the agent should relay to their user. -->
+<!-- This should be warm, conversational, user-facing — not a changelog. -->
+<!-- Focus on what THEY can now do, not internal plumbing. -->
+<!--                                                                    -->
+<!-- PROHIBITED in this section (will fail validation):                 -->
+<!--   camelCase config keys: silentReject, maxRetries, telegramNotify -->
+<!--   Inline code backtick references like silentReject: false        -->
+<!--   Fenced code blocks                                              -->
+<!--   Instructions to edit files or run commands                      -->
+<!--                                                                    -->
+<!-- CORRECT style: "I can turn that on for you" not "set X to false"  -->
+<!-- The agent relays this to their user — keep it human.              -->
+
+- **[Feature name]**: "[Brief, friendly description of what this means for the user]"
 
 ## Summary of New Capabilities
 
-- Slack messaging adapter with Socket Mode (real-time WebSocket, no webhooks needed)
-- DIY app model — each user creates their own Slack app, no shared infrastructure
-- Browser-automated setup wizard (Playwright drives workspace creation, app config, token extraction)
-- Session channel registry with bidirectional channel-to-session mapping
-- Channel resume map for conversation continuity across session restarts
-- Attention channel for critical alerts (auto-created, users auto-invited)
-- Dashboard link broadcast to Slack dashboard channel (update-in-place, no spam)
-- Slash commands via ! prefix (!sessions, !new, !help)
-- Platform badges on dashboard session cards
-- Platform dropdown when creating new sessions
-- Job scheduler integration (per-job Slack channels)
-- Cross-platform alerts (Slack added alongside Telegram and WhatsApp)
-- Presence proxy routing to correct session channels
-- SlackLifeline process for persistent Socket Mode connection
-- Autonomous mode skill with stop hook enforcement and session isolation
-- Unanswered message detection in Slack context hook
-- Message logging, search, and retention for Slack
+| Capability | How to Use |
+|-----------|-----------|
+| [Capability] | [Endpoint, command, or "automatic"] |

package/upgrades/0.24.19.md

@@ -0,0 +1,21 @@
+# Upgrade Guide — vNEXT
+
+<!-- bump: patch -->
+
+## What Changed
+
+### Systems Dashboard CSS Fix — v3 Styles Restored
+
+The Systems dashboard CSS was still referencing old v2 class names (`.capability-card`, `.cap-info`, `.cap-label`) while the JavaScript had been updated to generate v3 classes (`.cap-card`, `.cap-card-name`, `.cap-card-desc`, `.cap-grid`). This mismatch caused the dashboard cards to render without proper styling.
+
+The CSS has been fully replaced with v3 styles covering: card grid layout, detail views, stat cards, process list indicators, and responsive grid breakpoints.
+
+## What to Tell Your User
+
+The Systems dashboard styling has been fixed. If the cards and layout looked broken or unstyled, that's now resolved — everything renders cleanly with the new card grid design.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Systems dashboard CSS fix | Automatic — dashboard renders correctly now |

package/upgrades/0.24.21.md

@@ -0,0 +1,25 @@
+# v0.24.21 — Slack Stability & Image Support
+
+## What Changed
+
+**Slack Socket Mode heartbeat** — Fixed a reconnect death loop where the connection cycled every ~90 seconds on quiet channels. The heartbeat timeout is now 5 minutes instead of 60 seconds, since Slack only sends events when someone posts a message.
+
+**Workspace modes** — New workspaceMode config (dedicated or shared) with sensible defaults. Dedicated mode auto-joins channels and responds to all messages. Shared mode only responds when mentioned and does not auto-join. All settings individually overridable.
+
+**Image/file support in Slack** — Messages with file attachments are now downloaded and passed to sessions with explicit read instructions, matching the Telegram image pipeline.
+
+**Session injection race condition** — Fixed a timing issue where messages arriving shortly after session spawn could fail to inject because Claude was not ready yet. Now waits for Claude readiness before injection.
+
+**Smart port allocation** — New agents scan for free ports instead of blindly defaulting to 4040 when registry allocation fails.
+
+## What to Tell Your User
+
+Slack got more reliable this update. The bot no longer disconnects and reconnects in a loop on quiet channels. Images and files sent in Slack are now fully supported, just like Telegram. There is also a new workspace mode setting that controls whether the bot responds to every message or only when mentioned.
+
+## Summary of New Capabilities
+
+- Slack workspace modes: dedicated (respond to everything, auto-join channels) and shared (mention-only, no auto-join)
+- Slack image and file attachment support with automatic download and session delivery
+- Socket Mode connection stability fix (5-minute heartbeat instead of 60 seconds)
+- Session injection race condition fix for rapid message sequences
+- Smart port allocation for new agent initialization

package/upgrades/NEXT.md

@@ -0,0 +1,45 @@
+# Upgrade Guide — v0.24.20
+
+<!-- bump: patch -->
+
+## What Changed
+
+### Fix: Slack Socket Mode Heartbeat Death Loop
+
+The heartbeat timeout for Slack Socket Mode connections was 60 seconds — far too aggressive for quiet channels with no activity. This caused a connect-disconnect loop every ~90 seconds, dropping messages during reconnection windows. Increased to 5 minutes, which correctly detects zombie connections without false-positiving on idle channels.
+
+### Slack Workspace Modes (Dedicated vs Shared)
+
+SlackAdapter now supports two workspace modes:
+- **dedicated** (default): Agent owns the workspace. Auto-joins all public channels, responds to all messages.
+- **shared**: Agent is a guest in an existing workspace. Only responds to @mentions and DMs. Does not auto-join channels.
+
+Configure via `slack.workspaceMode` in config. The `respondMode` and `autoJoinChannels` settings can also be set independently.
+
+### Fix: GitSync Crash on Empty Repos
+
+GitSync now handles repos with no commits (freshly `git init`'d). Previously, `rev-parse HEAD` would throw and crash the sync process.
+
+### Fix: ServerSupervisor Grace Period After Restart
+
+When the Supervisor starts and finds the server already running (e.g., after a Lifeline self-restart for an update), it now correctly sets `spawnedAt` and checks for planned-exit markers. This prevents false "server down" alerts during update transitions.
+
+### Slack Image/Document Tags in Session Bootstrap
+
+`[image:path]` and `[document:path]` tags in Slack messages are now transformed into explicit read instructions before being passed to Claude sessions, improving reliability of file handling.
+
+### Browsable Stat Cards — Click Metrics to View Content
+
+Stat cards in the Systems detail view are now interactive. When a metric maps to browsable content, clicking the card fetches and displays the actual data inline.
+
+## What to Tell Your User
+
+A few reliability fixes in this release. If you were having trouble with Slack integration (agent not responding, connection dropping), that's fixed now — the connection was being too aggressive about reconnecting. Also added support for "shared" workspace mode if you want to install an agent into an existing Slack workspace without it taking over every channel.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Slack workspace modes | Set `slack.workspaceMode: "shared"` for guest-in-existing-workspace behavior |
+| Slack mention-only mode | Set `slack.respondMode: "mention-only"` to only respond to @mentions |
+| Browsable stat cards | Click any stat card with browsable content to expand it inline |