claude-slack-channel-bots 0.13.0 → 0.14.0

package/README.md

@@ -443,6 +443,7 @@ These top-level fields apply to the whole server. A confirmed change to one take
 | `mcp_config_path` | string | `~/.claude/slack-mcp.json` | Path to the MCP config file passed to Claude Code when launching managed sessions. |
 | `append_system_prompt_file` | string | — | Path to a file appended to every managed session's system prompt via `--append-system-prompt-file`. Missing file silently skipped. See `skills/EXAMPLE_CLAUDE.md` for a template. |
 | `system_prompt_mode` | string | `"append"` | Controls how `append_system_prompt_file` is applied. `"append"`: the custom prompt file is appended on top of `CLAUDE.md` (default, current behavior). `"none"`: only `CLAUDE.md` is used; `append_system_prompt_file` is ignored even if set. Use `"none"` when the project's `CLAUDE.md` already contains everything the bot needs. |
+| `fresh_system_prompt` | boolean | `true` | When `true` (default), every bot launches with `--system-prompt-snapshot off`, so a restarted or resumed bot loads the current system prompt file and `CLAUDE.md` and keeps its conversation, whatever `system_prompt_mode` is. When `false`, the flag is omitted. A change takes effect at the next server start. Needs a Claude Code that has `--system-prompt-snapshot` (confirmed on 2.1.280); on an older one set it to `false`. A bot keeps the launch arguments it was started with on every resume, so a change reaches a bot only when it next starts a new conversation; a `clean_restart` that resumes conversations does not apply it to those bots. |
 | `cozempic_prescription` | string | `"standard"` | Cozempic cleaning intensity before resume. Valid values: `gentle`, `standard`, `aggressive`. Has no effect if cozempic is not installed. |
 | `message_archive_db` | string | — | Path to a SQLite DB where every inbound Slack message is archived in real time. Parent directories are created if missing; schema is initialized on first open. Compatible with the `archive-messages.py` backfill script — both can write concurrently. Each channel's name is looked up through the receiving persona's Slack app, which needs the `channels:read` and `groups:read` bot scopes that the shipped `slack-app-manifest.yml` grants. An app created from an earlier manifest stores the channel ID instead, until both scopes are added and the app is re-installed; the `debug-slack-channel-bots` skill has the steps under "The message archive shows channel IDs". A DM's rows keep the DM's `D…` ID whatever the scopes, as a DM has no name; a group DM's rows keep its ID too. Feature is disabled when absent. |
 | `claude_config_dir` | string | — | Default Claude on-disk config directory for every persona. When a persona has one (its own or this default), its session launches with `CLAUDE_CONFIG_DIR='<resolved-path>'` so the bot authenticates against a specific account. `~` is expanded and the path is resolved to absolute. A persona's own `claude_config_dir` overrides this value. When neither is set, Claude's own default applies. Must be non-empty when set. |
@@ -2512,10 +2513,10 @@ Before any side-effecting step runs, `/publish` enforces eight fail-fast gates.
 
 After all gates pass, the skill, in this order:
 
-1. Bumps `package.json` and `bun.lock` to `<next-version>` (no commit, no tag yet).
+1. Bumps `package.json` and `bun.lock` to `<next-version>` (no commit, no tag yet), and turns `CHANGELOG.md`'s `## Unreleased` heading into `## <next-version> (<UTC date>)` under a fresh empty `## Unreleased` entry. With no `## Unreleased` heading, the release stops here and the working tree is rolled back.
 2. Packs the release tarball with `bun pm pack` and verifies its internal version matches.
 3. Scratch-installs the tarball into a temp `BUN_INSTALL` and runs the bin smoke check (non-zero exit + `Usage:` in stderr). Any failure here rolls back the working tree and aborts — no commit, no push, no publish.
-4. Creates the `Release v<version>` commit and the annotated `v<version>` tag locally.
+4. Creates the `Release v<version>` commit (`package.json`, `bun.lock` and `CHANGELOG.md`) and the annotated `v<version>` tag locally.
 5. Pushes the release commit to `origin/main`.
 6. Publishes the smoke-tested tarball with `npm publish <tarball-path>` (the smoke-tested artifact bytes — not a repack from CWD).
 7. Pushes the `v<version>` tag to `origin`, bringing GitHub and npm into agreement.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-slack-channel-bots",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Run several Claude Code personas, each its own Slack app, from one server via Socket Mode",
   "type": "module",
   "bin": {

package/src/agent-director-template.ts

@@ -136,6 +136,11 @@ export function deriveMemoryReadAllowRules(personaConfig: PersonaConfig, home: s
  * Conditionally appends `--append-system-prompt-file <path>` when
  * `system_prompt_mode === 'append'` and the path is R_OK-readable. An
  * unreadable path produces a single stderr warning and the flag is omitted.
+ *
+ * Then appends `--system-prompt-snapshot off` (b.b1j SR-2) unless
+ * `fresh_system_prompt` is exactly `false`; a configuration without the field
+ * gets the pair. It does not depend on `system_prompt_mode`, on the append
+ * file probe or on dry run, and is always the last two elements.
  */
 export function buildTemplateParams(
   personaConfig: PersonaConfig,
@@ -165,6 +170,13 @@ export function buildTemplateParams(
     }
   }
 
+  // b.b1j SR-2: last, whatever the append-file decision above was, so a
+  // resumed or restarted bot reloads the current system prompt file and
+  // CLAUDE.md. Only a `fresh_system_prompt` of exactly `false` leaves it out.
+  if (personaConfig.fresh_system_prompt !== false) {
+    claude_args.push('--system-prompt-snapshot', 'off')
+  }
+
   return {
     name: DEFAULT_TEMPLATE_NAME,
     relay_mode: 'on',

package/src/config.ts

@@ -122,6 +122,7 @@ const SHARED_TOP_LEVEL_KEYS = [
   'append_system_prompt_file',
   'cozempic_prescription',
   'system_prompt_mode',
+  'fresh_system_prompt',
   'message_archive_db',
   'claude_config_dir',
   'resume_enabled',
@@ -271,6 +272,13 @@ export interface ServerSettingsInput {
   append_system_prompt_file?: string
   cozempic_prescription?: string
   system_prompt_mode?: string
+  /**
+   * Whether bots launch with `--system-prompt-snapshot off`, so a resumed or
+   * restarted bot reloads the current system prompt file and `CLAUDE.md`
+   * (b.b1j SR-1). Absent means `true`; must be a boolean. Server-wide only: a
+   * persona entry cannot set it. A change takes effect at the next start.
+   */
+  fresh_system_prompt?: boolean
   /** Optional path to a SQLite DB where every inbound Slack message will be archived. */
   message_archive_db?: string
   /**
@@ -351,6 +359,11 @@ export interface ServerSettings {
   append_system_prompt_file?: string
   cozempic_prescription: string
   system_prompt_mode: string
+  /**
+   * Whether bots launch with `--system-prompt-snapshot off` (b.b1j SR-1).
+   * Defaults to true when absent; read by the template builder.
+   */
+  fresh_system_prompt: boolean
   /** Absolute path to SQLite archive DB. Undefined disables the feature. */
   message_archive_db?: string
   claude_config_dir?: string
@@ -603,6 +616,9 @@ function applyServerDefaults(input: ServerSettingsInput, configDir: string, cron
     append_system_prompt_file: input.append_system_prompt_file,
     cozempic_prescription: input.cozempic_prescription ?? 'standard',
     system_prompt_mode: input.system_prompt_mode ?? 'append',
+    // b.b1j SR-1: only an absent key takes the default: any other value,
+    // `null` included, is kept so the key's boolean rule rejects it.
+    fresh_system_prompt: input.fresh_system_prompt === undefined ? true : input.fresh_system_prompt,
     message_archive_db: input.message_archive_db,
     claude_config_dir: input.claude_config_dir,
     resume_enabled: input.resume_enabled ?? true,
@@ -1129,6 +1145,7 @@ function validatePersonaServerSettings(settings: PersonaServerSettings): void {
   validateServerTimingsAndModes(settings, style)
   checkOptionalNonEmptyString(settings.claude_config_dir, 'claude_config_dir', style)
   checkBoolean(settings.stop_hook_bootstrap, 'stop_hook_bootstrap', style)
+  checkBoolean(settings.fresh_system_prompt, 'fresh_system_prompt', style) // b.b1j SR-1
   validateServerPollAndCron(settings, style)
   checkOptionalNonEmptyString(settings.ack_reaction, 'ack_reaction', style)
   checkOptionalPositiveInteger(settings.reply_chunk_limit, 'reply_chunk_limit', style)