Release v1.4.3

Stop synchronous update checks before MCP stdio initialization and add regression coverage for the startup path.

Closes #17

Closes #18

Closes #19

Author: tomohiro-owada

CHANGELOG.md

@@ -5,6 +5,25 @@ 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).
 
+## [Unreleased]
+
+### Planned Features
+- Additional language model support
+- Batch indexing improvements
+- Enhanced error messages
+- Configuration validation tool
+- Performance monitoring and metrics
+
+## [1.4.3] - 2026-04-05
+
+### Fixed
+- **MCP startup handshake regression** - MCP mode no longer performs the synchronous GitHub update check before stdio initialization
+  - Prevents startup-time network requests from delaying or interfering with MCP `initialize`
+  - `update_check: false` is now respected before any update check is considered
+
+### Notes
+- Addresses the macOS Apple Silicon MCP startup report tracked in issue #19
+
 ## [1.3.1] - 2026-03-12
 
 ### Added
@@ -199,15 +218,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - GPU support currently limited to macOS Apple Silicon (Metal)
 - First run requires internet connection to download model files (~450MB)
 
-## [Unreleased]
-
-### Planned Features
-- Additional language model support
-- Batch indexing improvements
-- Enhanced error messages
-- Configuration validation tool
-- Performance monitoring and metrics
-
 ---
 
 For more information, see the [README](README.md).

cmd/main.go

@@ -15,6 +15,10 @@ import (
 	"github.com/tomohiro-owada/devrag/internal/version"
 )
 
+func shouldCheckForUpdates(isMCP bool, cfg *config.Config) bool {
+	return !isMCP && cfg != nil && cfg.IsUpdateCheckEnabled()
+}
+
 func main() {
 	// Extract global flags before subcommand
 	configPath := "config.json"
@@ -58,9 +62,6 @@ func main() {
 		fmt.Fprintf(os.Stderr, "[INFO] DevRag v%s\n", version.Version)
 	}
 
-	// Check for updates (synchronous, shown immediately after startup message)
-	updater.CheckForUpdate(version.Version, "")
-
 	// 1. Load configuration
 	cfg, err := config.Load(configPath)
 	if err != nil {
@@ -72,6 +73,12 @@ func main() {
 		os.Exit(1)
 	}
 
+	// Avoid blocking MCP stdio initialization on a network request.
+	// CLI mode can still perform the synchronous update notice.
+	if shouldCheckForUpdates(isMCP, cfg) {
+		updater.CheckForUpdate(version.Version, "")
+	}
+
 	if isMCP {
 		fmt.Fprintf(os.Stderr, "[INFO] Configuration loaded successfully\n")
 		fmt.Fprintf(os.Stderr, "[INFO] Document patterns: %v\n", cfg.DocumentPatterns)

cmd/main_test.go

@@ -0,0 +1,63 @@
+package main
+
+import (
+	"testing"
+
+	"github.com/tomohiro-owada/devrag/internal/config"
+)
+
+func TestShouldCheckForUpdates(t *testing.T) {
+	disabled := config.DefaultConfig()
+	updateCheckDisabled := false
+	disabled.UpdateCheck = &updateCheckDisabled
+
+	enabled := config.DefaultConfig()
+	updateCheckEnabled := true
+	enabled.UpdateCheck = &updateCheckEnabled
+
+	tests := []struct {
+		name  string
+		isMCP bool
+		cfg   *config.Config
+		want  bool
+	}{
+		{
+			name:  "cli mode with default config",
+			isMCP: false,
+			cfg:   config.DefaultConfig(),
+			want:  true,
+		},
+		{
+			name:  "cli mode with update check disabled",
+			isMCP: false,
+			cfg:   disabled,
+			want:  false,
+		},
+		{
+			name:  "cli mode with update check enabled",
+			isMCP: false,
+			cfg:   enabled,
+			want:  true,
+		},
+		{
+			name:  "mcp mode never checks",
+			isMCP: true,
+			cfg:   enabled,
+			want:  false,
+		},
+		{
+			name:  "nil config does not check",
+			isMCP: false,
+			cfg:   nil,
+			want:  false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			if got := shouldCheckForUpdates(tt.isMCP, tt.cfg); got != tt.want {
+				t.Fatalf("shouldCheckForUpdates(%v, %v) = %v, want %v", tt.isMCP, tt.cfg, got, tt.want)
+			}
+		})
+	}
+}

internal/version/version.go

@@ -2,4 +2,4 @@ package version
 
 // Version is the current version of DevRag
 // This is set at build time via -ldflags
-var Version = "1.4.2"
+var Version = "1.4.3"