feat(version): add CLI version check on extension startup

lua/shelltime/config.lua

@@ -11,6 +11,8 @@ local defaults = {
   heartbeat_interval = 120000, -- 2 minutes in ms
   debounce_interval = 30000,   -- 30 seconds in ms
   debug = false,
+  api_endpoint = nil,          -- API endpoint for version check
+  web_endpoint = nil,          -- Web endpoint for update command
 }
 
 -- Default config file path
@@ -20,6 +22,7 @@ local default_config_path = '~/.shelltime/config.yaml'
 local cached_config = nil
 local cached_mtime = nil
 local config_path = nil
+local test_mode = false
 
 --- Expand tilde in path
 ---@param path string Path with possible tilde
@@ -89,6 +92,15 @@ local function merge_config(file_config)
     config.debounce_interval = file_config.debounceInterval
   end
 
+  -- API and web endpoints for version check
+  if file_config.apiEndpoint then
+    config.api_endpoint = file_config.apiEndpoint
+  end
+
+  if file_config.webEndpoint then
+    config.web_endpoint = file_config.webEndpoint
+  end
+
   return config
 end
 
@@ -101,11 +113,17 @@ function M.setup(opts)
   -- Force reload
   cached_config = nil
   cached_mtime = nil
+  test_mode = false
 end
 
 --- Get merged configuration
 ---@return table Configuration
 function M.get_config()
+  -- In test mode, always return cached config
+  if test_mode and cached_config then
+    return cached_config
+  end
+
   local path = expand_path(config_path or default_config_path)
   local mtime = get_mtime(path)
 
@@ -142,4 +160,11 @@ function M.get_config_path()
   return config_path or default_config_path
 end
 
+--- Set config values directly (for testing only)
+---@param config_values table Config values to set
+function M._set_for_testing(config_values)
+  cached_config = vim.tbl_deep_extend('force', {}, defaults, config_values)
+  test_mode = true
+end
+
 return M

lua/shelltime/sender.lua

@@ -3,6 +3,7 @@
 local config = require('shelltime.config')
 local socket = require('shelltime.socket')
 local heartbeat = require('shelltime.heartbeat')
+local version = require('shelltime.version')
 
 local M = {}
 
@@ -63,9 +64,18 @@ function M.start()
     end)
   end)
 
-  -- Check initial connection status
+  -- Check initial connection status and CLI version
   vim.schedule(function()
     is_connected = socket.is_connected_sync()
+
+    -- Check CLI version in background (non-blocking)
+    if is_connected then
+      socket.get_status(function(status, err)
+        if status and status.version then
+          version.check_version(status.version)
+        end
+      end)
+    end
   end)
 end
 

lua/shelltime/version.lua

@@ -0,0 +1,146 @@
+-- Version checker for shelltime
+
+local config = require('shelltime.config')
+
+local M = {}
+
+-- Track if warning has been shown this session
+local has_shown_warning = false
+
+-- Version check API endpoint path
+local VERSION_CHECK_ENDPOINT = '/api/v1/cli/version-check'
+
+--- URL encode a string
+---@param str string String to encode
+---@return string Encoded string
+local function url_encode(str)
+  if str then
+    str = string.gsub(str, '\n', '\r\n')
+    str = string.gsub(str, '([^%w _%%%-%.~])', function(c)
+      return string.format('%%%02X', string.byte(c))
+    end)
+    str = string.gsub(str, ' ', '+')
+  end
+  return str
+end
+
+--- Parse JSON response using Neovim's built-in JSON decoder
+---@param json_str string JSON string
+---@return table|nil Parsed table or nil on error
+local function parse_json(json_str)
+  local ok, result = pcall(vim.json.decode, json_str)
+  if not ok or type(result) ~= 'table' then
+    return nil
+  end
+  return result
+end
+
+--- Check CLI version against server
+---@param daemon_version string Current daemon version
+---@param callback function|nil Optional callback(result, error)
+function M.check_version(daemon_version, callback)
+  local api_endpoint = config.get('api_endpoint')
+  local web_endpoint = config.get('web_endpoint')
+
+  if not api_endpoint or not web_endpoint then
+    if config.get('debug') then
+      vim.notify('[shelltime] No API/web endpoint configured, skipping version check', vim.log.levels.DEBUG)
+    end
+    if callback then
+      callback(nil, 'No endpoint configured')
+    end
+    return
+  end
+
+  if has_shown_warning then
+    if config.get('debug') then
+      vim.notify('[shelltime] Version warning already shown this session', vim.log.levels.DEBUG)
+    end
+    if callback then
+      callback(nil, 'Already shown')
+    end
+    return
+  end
+
+  local url = api_endpoint .. VERSION_CHECK_ENDPOINT .. '?version=' .. url_encode(daemon_version)
+
+  if config.get('debug') then
+    vim.notify('[shelltime] Checking version at: ' .. url, vim.log.levels.DEBUG)
+  end
+
+  -- Use curl asynchronously via vim.fn.jobstart
+  local stdout_data = {}
+
+  vim.fn.jobstart({ 'curl', '-sSL', '-m', '5', '-H', 'Accept: application/json', url }, {
+    stdout_buffered = true,
+    on_stdout = function(_, data)
+      if data then
+        for _, line in ipairs(data) do
+          if line ~= '' then
+            table.insert(stdout_data, line)
+          end
+        end
+      end
+    end,
+    on_exit = function(_, exit_code)
+      vim.schedule(function()
+        if exit_code ~= 0 then
+          if config.get('debug') then
+            vim.notify('[shelltime] Version check failed with exit code: ' .. exit_code, vim.log.levels.DEBUG)
+          end
+          if callback then
+            callback(nil, 'curl failed')
+          end
+          return
+        end
+
+        local response = table.concat(stdout_data, '')
+        local result = parse_json(response)
+
+        if result then
+          if not result.isLatest then
+            has_shown_warning = true
+            M.show_update_warning(daemon_version, result.latestVersion, web_endpoint)
+          elseif config.get('debug') then
+            vim.notify('[shelltime] CLI version ' .. daemon_version .. ' is up to date', vim.log.levels.DEBUG)
+          end
+
+          if callback then
+            callback(result, nil)
+          end
+        else
+          if config.get('debug') then
+            vim.notify('[shelltime] Failed to parse version check response', vim.log.levels.DEBUG)
+          end
+          if callback then
+            callback(nil, 'Parse error')
+          end
+        end
+      end)
+    end,
+  })
+end
+
+--- Show update warning notification
+---@param current_version string Current version
+---@param latest_version string Latest available version
+---@param web_endpoint string Web endpoint for update command
+function M.show_update_warning(current_version, latest_version, web_endpoint)
+  local update_command = 'curl -sSL ' .. web_endpoint .. '/i | bash'
+  local message = string.format(
+    '[shelltime] CLI update available: %s -> %s\n\nRun: %s',
+    current_version,
+    latest_version,
+    update_command
+  )
+
+  vim.notify(message, vim.log.levels.WARN)
+
+  -- Also copy to clipboard if available
+  if vim.fn.has('clipboard') == 1 then
+    vim.fn.setreg('+', update_command)
+    vim.notify('[shelltime] Update command copied to clipboard', vim.log.levels.INFO)
+  end
+end
+
+return M

tests/helpers/reset.lua

@@ -16,6 +16,7 @@ function M.reset_all()
     'shelltime.heartbeat',
     'shelltime.sender',
     'shelltime.socket',
+    'shelltime.version',
     'shelltime.utils',
     'shelltime.utils.system',
     'shelltime.utils.git',