claude-threads 1.21.2 → 1.22.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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).
 
+## [1.22.0] - 2026-08-08
+
+### Changed
+- **A newer Claude CLI no longer takes the bot down — the version check is now a three-tier policy.** Previously the single hard range `>=2.0.74 <2.2.0` meant that the day Anthropic ships CLI 2.2.0, every bot whose CLI auto-updates would refuse to start until a claude-threads release widened the range — the worst failure mode for a bot people depend on. Now: below the floor (`2.0.74`) or on a new major (3.x+) the bot still exits with an error (those genuinely can't work / are a different contract); but a **newer 2.x above the verified range starts normally with a visible warning** — at startup, in the terminal header, and as an "⚠️ untested" marker next to the CLI version in the sticky channel message and session headers. `--skip-version-check` still bypasses the hard exits, and a bypassed hard exit is no longer silent either: the bot warns at startup and marks the version "⚠️ unsupported" in the same places. Onboarding speaks the same policy (warn-and-continue on untested, tier-specific messages on the hard tiers). The verified range (latest verified: 2.1.223) is unchanged; when a new CLI minor ships, it gets verified and the range bumped in a patch release — the warning is the prompt to do that, not a permanent state.
+
 ## [1.21.2] - 2026-08-07
 
 ### Added

package/dist/index.js

@@ -16965,8 +16965,8 @@ var require_gt3 = __commonJS((exports, module) => {
 // node_modules/package-json/node_modules/semver/functions/lt.js
 var require_lt2 = __commonJS((exports, module) => {
   var compare = require_compare3();
-  var lt = (a, b, loose) => compare(a, b, loose) < 0;
-  module.exports = lt;
+  var lt2 = (a, b, loose) => compare(a, b, loose) < 0;
+  module.exports = lt2;
 });
 
 // node_modules/package-json/node_modules/semver/functions/eq.js
@@ -17003,7 +17003,7 @@ var require_cmp2 = __commonJS((exports, module) => {
   var neq = require_neq2();
   var gt = require_gt3();
   var gte = require_gte2();
-  var lt = require_lt2();
+  var lt2 = require_lt2();
   var lte = require_lte2();
   var cmp = (a, op, b, loose) => {
     switch (op) {
@@ -17034,7 +17034,7 @@ var require_cmp2 = __commonJS((exports, module) => {
       case ">=":
         return gte(a, b, loose);
       case "<":
-        return lt(a, b, loose);
+        return lt2(a, b, loose);
       case "<=":
         return lte(a, b, loose);
       default:
@@ -17755,7 +17755,7 @@ var require_outside2 = __commonJS((exports, module) => {
   var Range = require_range2();
   var satisfies2 = require_satisfies2();
   var gt = require_gt3();
-  var lt = require_lt2();
+  var lt2 = require_lt2();
   var lte = require_lte2();
   var gte = require_gte2();
   var outside = (version, range, hilo, options) => {
@@ -17766,12 +17766,12 @@ var require_outside2 = __commonJS((exports, module) => {
       case ">":
         gtfn = gt;
         ltefn = lte;
-        ltfn = lt;
+        ltfn = lt2;
         comp = ">";
         ecomp = ">=";
         break;
       case "<":
-        gtfn = lt;
+        gtfn = lt2;
         ltefn = gte;
         ltfn = gt;
         comp = "<";
@@ -17937,12 +17937,12 @@ var require_subset2 = __commonJS((exports, module) => {
       }
     }
     const eqSet = new Set;
-    let gt, lt;
+    let gt, lt2;
     for (const c of sub) {
       if (c.operator === ">" || c.operator === ">=") {
         gt = higherGT(gt, c, options);
       } else if (c.operator === "<" || c.operator === "<=") {
-        lt = lowerLT(lt, c, options);
+        lt2 = lowerLT(lt2, c, options);
       } else {
         eqSet.add(c.semver);
       }
@@ -17951,11 +17951,11 @@ var require_subset2 = __commonJS((exports, module) => {
       return null;
     }
     let gtltComp;
-    if (gt && lt) {
-      gtltComp = compare(gt.semver, lt.semver, options);
+    if (gt && lt2) {
+      gtltComp = compare(gt.semver, lt2.semver, options);
       if (gtltComp > 0) {
         return null;
-      } else if (gtltComp === 0 && (gt.operator !== ">=" || lt.operator !== "<=")) {
+      } else if (gtltComp === 0 && (gt.operator !== ">=" || lt2.operator !== "<=")) {
         return null;
       }
     }
@@ -17963,7 +17963,7 @@ var require_subset2 = __commonJS((exports, module) => {
       if (gt && !satisfies2(eq, String(gt), options)) {
         return null;
       }
-      if (lt && !satisfies2(eq, String(lt), options)) {
+      if (lt2 && !satisfies2(eq, String(lt2), options)) {
         return null;
       }
       for (const c of dom) {
@@ -17975,9 +17975,9 @@ var require_subset2 = __commonJS((exports, module) => {
     }
     let higher, lower;
     let hasDomLT, hasDomGT;
-    let needDomLTPre = lt && !options.includePrerelease && lt.semver.prerelease.length ? lt.semver : false;
+    let needDomLTPre = lt2 && !options.includePrerelease && lt2.semver.prerelease.length ? lt2.semver : false;
     let needDomGTPre = gt && !options.includePrerelease && gt.semver.prerelease.length ? gt.semver : false;
-    if (needDomLTPre && needDomLTPre.prerelease.length === 1 && lt.operator === "<" && needDomLTPre.prerelease[0] === 0) {
+    if (needDomLTPre && needDomLTPre.prerelease.length === 1 && lt2.operator === "<" && needDomLTPre.prerelease[0] === 0) {
       needDomLTPre = false;
     }
     for (const c of dom) {
@@ -17998,29 +17998,29 @@ var require_subset2 = __commonJS((exports, module) => {
           return false;
         }
       }
-      if (lt) {
+      if (lt2) {
         if (needDomLTPre) {
           if (c.semver.prerelease && c.semver.prerelease.length && c.semver.major === needDomLTPre.major && c.semver.minor === needDomLTPre.minor && c.semver.patch === needDomLTPre.patch) {
             needDomLTPre = false;
           }
         }
         if (c.operator === "<" || c.operator === "<=") {
-          lower = lowerLT(lt, c, options);
-          if (lower === c && lower !== lt) {
+          lower = lowerLT(lt2, c, options);
+          if (lower === c && lower !== lt2) {
             return false;
           }
-        } else if (lt.operator === "<=" && !satisfies2(lt.semver, String(c), options)) {
+        } else if (lt2.operator === "<=" && !satisfies2(lt2.semver, String(c), options)) {
           return false;
         }
       }
-      if (!c.operator && (lt || gt) && gtltComp !== 0) {
+      if (!c.operator && (lt2 || gt) && gtltComp !== 0) {
         return false;
       }
     }
-    if (gt && hasDomLT && !lt && gtltComp !== 0) {
+    if (gt && hasDomLT && !lt2 && gtltComp !== 0) {
       return false;
     }
-    if (lt && hasDomGT && !gt && gtltComp !== 0) {
+    if (lt2 && hasDomGT && !gt && gtltComp !== 0) {
       return false;
     }
     if (needDomGTPre || needDomLTPre) {
@@ -18067,7 +18067,7 @@ var require_semver5 = __commonJS((exports, module) => {
   var sort = require_sort2();
   var rsort = require_rsort2();
   var gt = require_gt3();
-  var lt = require_lt2();
+  var lt2 = require_lt2();
   var eq = require_eq2();
   var neq = require_neq2();
   var gte = require_gte2();
@@ -18105,7 +18105,7 @@ var require_semver5 = __commonJS((exports, module) => {
     sort,
     rsort,
     gt,
-    lt,
+    lt: lt2,
     eq,
     neq,
     gte,
@@ -51296,6 +51296,7 @@ var dim = (s) => `${colors.dim}${s}${colors.reset}`;
 var bold = (s) => `${colors.bold}${s}${colors.reset}`;
 var green = (s) => `${colors.green}${s}${colors.reset}`;
 var red = (s) => `${colors.red}${s}${colors.reset}`;
+var yellow = (s) => `${colors.yellow}${s}${colors.reset}`;
 
 // src/claude/version-check.ts
 var import_semver = __toESM(require_semver2(), 1);
@@ -51315,7 +51316,10 @@ var COMMON_CLAUDE_PATHS = process.platform === "win32" ? [
   `${process.env.HOME}/.bun/bin/claude`,
   "/usr/local/lib/node_modules/@anthropic-ai/claude-code/cli.js"
 ];
-var CLAUDE_CLI_VERSION_RANGE = ">=2.0.74 <2.2.0";
+var CLAUDE_CLI_MIN_VERSION = "2.0.74";
+var CLAUDE_CLI_VERIFIED_RANGE = ">=2.0.74 <2.2.0";
+var CLAUDE_CLI_SUPPORTED_MAJOR = 2;
+var CLAUDE_CLI_LATEST_VERIFIED = "2.1.223";
 function tryClaudeVersion(claudePath) {
   try {
     const output = execSync(`"${claudePath}" --version`, {
@@ -51387,11 +51391,17 @@ function getClaudeCliVersion() {
     error: `Command 'claude' not found. Searched: ${checkedPaths.slice(0, 3).join(", ")}...`
   };
 }
-function isVersionCompatible(version) {
+function classifyClaudeVersion(version) {
   const semverVersion = import_semver.coerce(version);
   if (!semverVersion)
-    return false;
-  return import_semver.satisfies(semverVersion, CLAUDE_CLI_VERSION_RANGE);
+    return "incompatible";
+  if (import_semver.lt(semverVersion, CLAUDE_CLI_MIN_VERSION))
+    return "incompatible";
+  if (semverVersion.major > CLAUDE_CLI_SUPPORTED_MAJOR)
+    return "incompatible";
+  if (import_semver.satisfies(semverVersion, CLAUDE_CLI_VERIFIED_RANGE))
+    return "ok";
+  return "untested";
 }
 function getClaudePath() {
   if (process.env.CLAUDE_PATH) {
@@ -51419,36 +51429,41 @@ function validateClaudeCli() {
       installed: false,
       version: null,
       compatible: false,
+      status: "incompatible",
       message: `Claude CLI not found at '${claudePath}'. Install it with: npm install -g @anthropic-ai/claude-code`,
       error: result.error
     };
   }
-  if (!result.version && result.rawOutput) {
+  if (!result.version) {
     return {
       installed: true,
       version: null,
       compatible: true,
+      status: "ok",
       message: `Claude CLI found (version unknown)`,
-      rawOutput: result.rawOutput
+      rawOutput: result.rawOutput ?? undefined
     };
   }
-  if (!result.version) {
+  const status = classifyClaudeVersion(result.version);
+  if (status === "incompatible") {
+    const semverVersion = import_semver.coerce(result.version);
+    const reason = semverVersion && semverVersion.major > CLAUDE_CLI_SUPPORTED_MAJOR ? `is a new major version (only ${CLAUDE_CLI_SUPPORTED_MAJOR}.x is supported)` : `is too old (minimum: ${CLAUDE_CLI_MIN_VERSION})`;
     return {
       installed: true,
-      version: null,
-      compatible: true,
-      message: "Claude CLI found (version unknown)",
+      version: result.version,
+      compatible: false,
+      status,
+      message: `Claude CLI version ${result.version} ${reason}. ` + `Install a verified version: npm install -g @anthropic-ai/claude-code@${CLAUDE_CLI_LATEST_VERIFIED}`,
       rawOutput: result.rawOutput ?? undefined
     };
   }
-  const compatible = isVersionCompatible(result.version);
-  if (!compatible) {
+  if (status === "untested") {
     return {
       installed: true,
       version: result.version,
-      compatible: false,
-      message: `Claude CLI version ${result.version} is not compatible. Required: ${CLAUDE_CLI_VERSION_RANGE}
-` + `Install a compatible version: npm install -g @anthropic-ai/claude-code@2.1.223`,
+      compatible: true,
+      status,
+      message: `Claude CLI ${result.version} is newer than the latest verified version (${CLAUDE_CLI_LATEST_VERIFIED}) — untested, continuing anyway. ` + `Features may misbehave; pin a verified version with: npm install -g @anthropic-ai/claude-code@${CLAUDE_CLI_LATEST_VERIFIED}`,
       rawOutput: result.rawOutput ?? undefined
     };
   }
@@ -51456,6 +51471,7 @@ function validateClaudeCli() {
     installed: true,
     version: result.version,
     compatible: true,
+    status,
     message: `Claude CLI ${result.version} ✓`,
     rawOutput: result.rawOutput ?? undefined
   };
@@ -51694,34 +51710,30 @@ async function runOnboarding(reconfigure = false) {
   }
   if (!claudeCheck.compatible) {
     console.log("");
-    if (claudeCheck.version) {
-      console.log(dim(`  ⚠️  Claude Code CLI ${claudeCheck.version} is not compatible`));
-      console.log("");
-      console.log(dim(`  Install a compatible version:`));
-      console.log(dim("    npm install -g @anthropic-ai/claude-code@2.1.223"));
-    } else {
-      console.log(dim("  ⚠️  Claude Code CLI found but version could not be determined"));
-      if (claudeCheck.rawOutput) {
-        console.log(dim(`  Output from "claude --version": ${claudeCheck.rawOutput}`));
-      }
-      console.log("");
-      console.log(dim("  This may work fine - Claude was installed in a non-standard way."));
-    }
+    console.log(dim(`  ⚠️  ${claudeCheck.message}`));
     console.log("");
     const { continueAnyway } = await import_prompts.default({
       type: "confirm",
       name: "continueAnyway",
       message: "Continue anyway? (may not work correctly)",
-      initial: !claudeCheck.version
+      initial: false
     }, { onCancel });
     if (!continueAnyway) {
       console.log("");
       console.log(dim("  Setup cancelled."));
       process.exit(0);
     }
+  } else if (claudeCheck.status === "untested") {
+    console.log("");
+    console.log(dim(`  ⚠️  ${claudeCheck.message}`));
+  } else if (!claudeCheck.version) {
+    console.log(dim("  ⚠️  Claude Code CLI found but version could not be determined"));
+    if (claudeCheck.rawOutput) {
+      console.log(dim(`  Output from "claude --version": ${claudeCheck.rawOutput}`));
+    }
+    console.log(dim("  This may work fine - Claude was installed in a non-standard way."));
   } else {
-    const versionInfo = claudeCheck.version ?? "version unknown";
-    console.log(dim(`  ✓ Claude Code CLI ${versionInfo}`));
+    console.log(dim(`  ✓ Claude Code CLI ${claudeCheck.version}`));
   }
   console.log("");
   console.log(dim("  \uD83D\uDCD6 Need help creating a bot?"));
@@ -53034,7 +53046,11 @@ function formatRelativeTimeShort(date) {
 }
 function formatVersionString() {
   const claudeVersion = getClaudeCliVersion().version;
-  return claudeVersion ? `CT v${VERSION} · CC v${claudeVersion}` : `CT v${VERSION}`;
+  if (!claudeVersion)
+    return `CT v${VERSION}`;
+  const status = classifyClaudeVersion(claudeVersion);
+  const marker = status === "untested" ? " ⚠️ untested" : status === "incompatible" ? " ⚠️ unsupported" : "";
+  return `CT v${VERSION} · CC v${claudeVersion}${marker}`;
 }
 function truncateAtWord(str2, maxLength) {
   if (str2.length <= maxLength)
@@ -77414,7 +77430,7 @@ var import_react61 = __toESM(require_react(), 1);
 
 // src/ui/components/Header.tsx
 var jsx_dev_runtime = __toESM(require_jsx_dev_runtime(), 1);
-function Header({ version, workingDir, claudeVersion }) {
+function Header({ version, workingDir, claudeVersion, claudeStatus }) {
   return /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Box_default, {
     borderStyle: "round",
     paddingX: 1,
@@ -77500,7 +77516,15 @@ function Header({ version, workingDir, claudeVersion }) {
               " | Claude ",
               claudeVersion
             ]
-          }, undefined, true, undefined, this)
+          }, undefined, true, undefined, this),
+          claudeStatus === "untested" && /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            color: "yellow",
+            children: " ⚠ untested"
+          }, undefined, false, undefined, this),
+          claudeStatus === "incompatible" && /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            color: "yellow",
+            children: " ⚠ unsupported"
+          }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
     ]
@@ -81468,7 +81492,8 @@ function App2({ config, onStateReady, onResizeReady, onQuit, toggleCallbacks })
   const headerContent = /* @__PURE__ */ jsx_dev_runtime13.jsxDEV(Header, {
     version: config.version,
     workingDir: config.workingDir,
-    claudeVersion: config.claudeVersion
+    claudeVersion: config.claudeVersion,
+    claudeStatus: config.claudeStatus
   }, undefined, false, undefined, this);
   const footerContent = /* @__PURE__ */ jsx_dev_runtime13.jsxDEV(Footer, {
     ready: state.ready,
@@ -81856,7 +81881,8 @@ class HeadlessProvider {
     const { config } = this.options;
     this.log("HeadlessProvider", `claude-threads v${config.version} starting in headless mode`);
     this.log("HeadlessProvider", `Working directory: ${config.workingDir}`);
-    this.log("HeadlessProvider", `Claude CLI: ${config.claudeVersion}`);
+    const cliMarker = config.claudeStatus === "untested" ? " ⚠️ untested (newer than the verified range)" : config.claudeStatus === "incompatible" ? " ⚠️ unsupported (version check bypassed)" : "";
+    this.log("HeadlessProvider", `Claude CLI: ${config.claudeVersion}${cliMarker}`);
   }
   async stop() {
     this.log("HeadlessProvider", "Stopped");
@@ -83277,6 +83303,15 @@ async function startWithoutDaemon() {
     console.error("");
     process.exit(1);
   }
+  if (claudeValidation.status === "untested") {
+    console.error(yellow(`  ⚠️  ${claudeValidation.message}`));
+    console.error("");
+  }
+  if (!claudeValidation.compatible && opts.skipVersionCheck) {
+    const prefix = claudeValidation.installed ? "running with an unsupported Claude CLI. " : "";
+    console.error(yellow(`  ⚠️  --skip-version-check: ${prefix}${claudeValidation.message}`));
+    console.error("");
+  }
   if (process.env.CLAUDE_CODE_SUBPROCESS_ENV_SCRUB === "1") {
     const hasSkipPermissionPlatform = config.platforms.some((p) => p.skipPermissions === true);
     if (hasSkipPermissionPlatform) {
@@ -83311,7 +83346,7 @@ async function startWithoutDaemon() {
       version: VERSION,
       workingDir,
       claudeVersion: claudeValidation.version || "unknown",
-      claudeCompatible: claudeValidation.compatible,
+      claudeStatus: claudeValidation.status,
       permissionMode: runtimeConfig.permissionMode,
       chromeEnabled: runtimeConfig.chromeEnabled,
       keepAliveEnabled: runtimeConfig.keepAliveEnabled

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "1.21.2",
+  "version": "1.22.0",
   "description": "Run Claude Code from Slack or Mattermost. Sessions stream live into threads where your whole team can watch and steer.",
   "main": "dist/index.js",
   "type": "module",