chore(release): v0.15.22 - Critical i18n Enhancement & Test Migration Fix

- **Critical i18n Enhancement**: Fixed remaining untranslated keys for complete locale coverage
  - Added missing error.noArguments and error.parameterRequired keys to TR/EN locales
  - Enhanced embedded locale system for NPX package compatibility
  - Added fallback strings in handlers.go (lines 2389, 2502, 2651, 2731, 2837)
  - Ensures robust operation across all deployment methods

- **Test Migration System Fix**: Resolved file:// URL path resolution in test migrations
  - Fixed migrateDB function to properly handle file:// URLs in migration paths
  - Added URL parsing and absolute path conversion for reliable file system access
  - Updated TestMigrationsPathIntegration constant for correct relative path resolution
  - All integration tests now pass with proper database schema migration

- **Version Synchronization**: Updated all components to v0.15.22
  - gorev-mcpserver: v0.15.20 → v0.15.22
  - Documentation: Standardized version references across all docs
  - Multi-platform binary builds with correct version injection

Author: msenol

CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [v0.15.22] - 2025-09-21
+
+### Fixed
+- **Critical i18n System Enhancement**: Fixed remaining untranslated keys for NPX package environments
+  - **Root Cause**: Missing `error.noArguments` and `error.parameterRequired` keys in locale files
+  - **Solution**: Added missing error keys to both Turkish and English locale files
+  - **Implementation**: Updated embedded locale system with missing keys for NPX compatibility
+  - **Fallback Enhancement**: Added fallback strings in handlers for all error keys
+  - **User Impact**: Complete i18n coverage ensures robust operation across all deployment methods
+  - **Affected Components**: MCP server, NPX package, VS Code extension
+
+### Changed
+- **Version Synchronization**: Updated all components to v0.15.22 for consistency
+  - **gorev-mcpserver**: v0.15.20 → v0.15.22
+  - **gorev-npm**: v0.15.20 → v0.15.22
+  - **gorev-vscode**: v0.15.21 → v0.15.22
+  - **VSIX Package**: Created gorev-vscode-0.15.22.vsix (325.75 KB, 147 files)
+
+## [v0.15.20] - 2025-09-21
+
+### Fixed
+- **Migration State Repair**: Fixed "table already exists" errors in NPX package environments
+  - **Root Cause**: Existing databases had tables but missing migration state records
+  - **Solution**: Added `repairMigrationStateIfNeeded()` function to auto-detect and repair migration state
+  - **Implementation**: Checks for existing core tables (projeler, gorevler, baglantilar) and reconstructs migration history
+  - **Safety**: Non-destructive repair that only adds missing migration records
+  - **User Impact**: NPX package now works seamlessly with existing databases
+
+### Added
+- **Linux ARM64 Support**: Added native binary support for ARM64 Linux platforms
+  - **New Binary**: `gorev-npm/binaries/linux-arm64/gorev` for Raspberry Pi and ARM64 servers
+  - **Cross-platform Build**: Complete multi-architecture support (Windows x64, macOS x64/ARM64, Linux x64/ARM64)
+  - **NPM Package**: Automatic platform detection and binary download
+
+### Changed
+- **Version Update**: NPM package version bumped to v0.15.20 for proper semver tracking
+
+## [v0.15.19] - 2025-09-21
+
 ### Fixed
 - **Critical VS Code Extension Bug**: Fixed task dependency display issue where dependencies weren't showing in VS Code extension
   - **MCP Server Fix**: Expanded dependency type support in `handlers.go` to include "blocker" and "depends_on" types alongside "onceki"

CLAUDE.md

@@ -2,15 +2,49 @@
 
 This file provides essential guidance to AI assistants using MCP (Model Context Protocol) when working with code in this repository. Compatible with Claude Code, VS Code with MCP extension, Windsurf, Cursor, and other MCP-enabled editors.
 
-**Last Updated:** 21 September 2025 | **Version:** v0.15.19
+**Last Updated:** 21 September 2025 | **Version:** v0.15.22
 
 [🇺🇸 English](CLAUDE.en.md) | [🇹🇷 Türkçe](CLAUDE.md)
 
 > 🤖 **Documentation Note**: This technical guide is optimized for token efficiency while maintaining essential information for AI assistants.
 
 ## 🚀 Recent Major Update
 
-**v0.15.19 - Critical VS Code Extension Dependency Display Fix (21 Sep 2025)**
+**v0.15.22 - Critical i18n System Enhancement (21 Sep 2025)**
+
+- **Critical i18n System Enhancement**: Fixed remaining untranslated keys for NPX package environments
+  - **Problem**: Missing `error.noArguments` and `error.parameterRequired` keys caused raw key display in error scenarios
+  - **Root Cause**: Incomplete locale files and embedded locale system missing error keys
+  - **Solution**: Added missing error keys to both Turkish and English locale files
+  - **Implementation**: Updated embedded locale system with missing keys for NPX compatibility
+  - **Fallback Enhancement**: Added fallback strings in handlers for all error keys (lines 2389, 2502, 2651, 2731, 2837)
+  - **User Impact**: Complete i18n coverage ensures robust operation across all deployment methods
+  - **Quality**: Rule 15 compliant with comprehensive solution, no workarounds
+
+- **Version Synchronization**: Updated all components to v0.15.22 for consistency
+  - **gorev-mcpserver**: v0.15.20 → v0.15.22
+  - **gorev-npm**: v0.15.20 → v0.15.22
+  - **gorev-vscode**: v0.15.21 → v0.15.22
+  - **VSIX Package**: Created gorev-vscode-0.15.22.vsix (325.75 KB, 147 files)
+
+**Previous: v0.15.20 - Migration State Repair & Linux ARM64 Support (21 Sep 2025)**
+
+- **Migration State Repair**: Fixed migration issues in NPX package environments
+  - **Problem**: Users reported "table already exists" errors when running `npx @mehmetsenol/gorev-mcp-server@latest`
+  - **Root Cause**: Existing databases had tables but missing migration state records
+  - **Solution**: Added `repairMigrationStateIfNeeded()` function to auto-detect and repair migration state
+  - **Implementation**: Checks for existing core tables (projeler, gorevler, baglantilar) and reconstructs migration history
+  - **Safety**: Non-destructive repair that only adds missing migration records
+  - **User Impact**: NPX package now works seamlessly with existing databases
+
+- **Linux ARM64 Support**: Added native binary support for ARM64 Linux platforms
+  - **New Binary**: `gorev-npm/binaries/linux-arm64/gorev` for Raspberry Pi and ARM64 servers
+  - **Cross-platform Build**: Complete multi-architecture support (Windows x64, macOS x64/ARM64, Linux x64/ARM64)
+  - **NPM Package**: Automatic platform detection and binary download
+
+- **Version Update**: NPM package version bumped to v0.15.20 for proper semver tracking
+
+**Previous: v0.15.19 - Critical VS Code Extension Dependency Display Fix (21 Sep 2025)**
 
 - **Critical Bug Fix**: Fixed task dependency display issue in VS Code extension
   - **Problem**: SQL Injection task and others showed "This task has no dependencies yet" despite having dependencies in database

README.en.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-**Last Updated:** September 20, 2025 | **Version:** v0.15.18
+**Last Updated:** September 21, 2025 | **Version:** v0.15.22
 
 [🇺🇸 English](README.en.md) | [🇹🇷 Türkçe](README.md)
 
@@ -79,6 +79,8 @@ Thanks to the MCP protocol, you can connect to the server from any MCP-compatibl
 
 ### 🚀 NPX Easy Setup (Easiest!)
 
+> ⚠️ **Windows Users**: NPX requires Node.js installation. [Download Node.js](https://nodejs.org/) and restart your system after installation.
+
 For MCP clients, simply add to your `mcp.json` configuration:
 
 ```json
@@ -126,6 +128,33 @@ For MCP clients, simply add to your `mcp.json` configuration:
 }
 ```
 
+#### 🔧 Windows NPX Troubleshooting
+
+If you get `ENOENT: spawn npx` error:
+
+1. **Check if Node.js is installed:**
+   ```cmd
+   node --version
+   npm --version
+   npx --version
+   ```
+
+2. **Install Node.js:**
+   - Download LTS version from [Node.js website](https://nodejs.org/)
+   - Check "Add to PATH" option during installation
+   - Restart your computer after installation
+
+3. **Install NPX separately (if needed):**
+   ```cmd
+   npm install -g npx
+   ```
+
+4. **Check PATH:**
+   ```cmd
+   echo %PATH%
+   ```
+   Should include Node.js paths (`C:\Program Files\nodejs\`).
+
 **For Cursor:**
 ```json
 {

README.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-**Last Updated:** September 21, 2025 | **Version:** v0.15.19
+**Last Updated:** September 21, 2025 | **Version:** v0.15.22
 
 [🇺🇸 English](README.en.md) | [🇹🇷 Türkçe](README.md)
 
@@ -94,6 +94,8 @@ MCP protokolü sayesinde server'a herhangi bir MCP uyumlu editörden bağlanabil
 
 ### 🚀 NPX ile Kolay Kurulum (En Kolay!)
 
+> ⚠️ **Windows Kullanıcıları**: NPX kullanımı için Node.js kurulumu gereklidir. [Node.js indirin](https://nodejs.org/) ve yükledikten sonra sistemi yeniden başlatın.
+
 MCP client'larında kullanmak için sadece `mcp.json` dosyasına ekleme yapın:
 
 ```json
@@ -141,6 +143,33 @@ MCP client'larında kullanmak için sadece `mcp.json` dosyasına ekleme yapın:
 }
 ```
 
+#### 🔧 Windows NPX Kurulum Sorunu Giderme
+
+Eğer `ENOENT: spawn npx` hatası alıyorsanız:
+
+1. **Node.js kurulu mu kontrol edin:**
+   ```cmd
+   node --version
+   npm --version
+   npx --version
+   ```
+
+2. **Node.js kurulumunu yapın:**
+   - [Node.js websitesinden](https://nodejs.org/) LTS sürümü indirin
+   - Installer'ı çalıştırırken "Add to PATH" seçeneğini işaretleyin
+   - Kurulum sonrası bilgisayarı yeniden başlatın
+
+3. **NPX ayrı kurulumu (gerekirse):**
+   ```cmd
+   npm install -g npx
+   ```
+
+4. **PATH kontrolü:**
+   ```cmd
+   echo %PATH%
+   ```
+   Node.js paths (`C:\Program Files\nodejs\`) görünmeli.
+
 ### 🔧 Geleneksel Kurulum (Otomatik)
 
 ```bash

docs/README.md

@@ -1,6 +1,6 @@
 # 📚 Gorev Documentation Index
 
-**Version**: v0.15.19
+**Version**: v0.15.22
 **Last Updated**: September 21, 2025  
 **Status**: Production Ready  
 

docs/api/reference.md

@@ -1,7 +1,7 @@
 # Gorev API Reference
 
-> **Version**: This documentation is valid for v0.15.5+
-> **Last Updated**: September 18, 2025
+> **Version**: This documentation is valid for v0.15.22+
+> **Last Updated**: September 21, 2025
 
 Complete API reference for Gorev MCP server, data models, and programmatic interfaces.
 

docs/tr/README.md

@@ -1,6 +1,6 @@
 # 📚 Gorev Türkçe Belgelendirme
 
-**Sürüm**: v0.15.19 | **Production Hazır** | **Rule 15 Uyumlu**
+**Sürüm**: v0.15.22 | **Production Hazır** | **Rule 15 Uyumlu**
 
 <div align="center">
 

gorev-mcpserver/Makefile

@@ -4,7 +4,7 @@ GO=go
 GOFLAGS=-v
 
 # Versiyon bilgisi
-VERSION ?= 0.15.19
+VERSION ?= 0.15.22
 BUILD_TIME=$(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
 GIT_COMMIT=$(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
 

gorev-mcpserver/cmd/gorev/main.go

@@ -17,7 +17,7 @@ import (
 )
 
 var (
-	version   = "v0.15.19"
+	version   = "v0.15.22"
 	buildTime = "unknown"
 	gitCommit = "unknown"
 	langFlag  string

gorev-mcpserver/internal/gorev/veri_yonetici.go

@@ -68,8 +68,27 @@ func (vy *VeriYonetici) migrateDB(migrationsYolu string) error {
 	}
 	log.Printf("DEBUG: Schema migrations table ready")
 
+	// Check if database needs migration state repair
+	if err := vy.repairMigrationStateIfNeeded(); err != nil {
+		log.Printf("WARNING: Migration state repair failed: %v", err)
+		// Continue with normal migration process
+	}
+
+	// Parse migration path and remove file:// prefix if present
+	migrationsPath := migrationsYolu
+	if strings.HasPrefix(migrationsPath, "file://") {
+		migrationsPath = strings.TrimPrefix(migrationsPath, "file://")
+		// Make relative paths absolute
+		if !filepath.IsAbs(migrationsPath) {
+			if abs, err := filepath.Abs(migrationsPath); err == nil {
+				migrationsPath = abs
+			}
+		}
+	}
+	log.Printf("DEBUG: Using filesystem path: %s", migrationsPath)
+
 	// Read migration files from directory
-	migrationFiles, err := filepath.Glob(filepath.Join(migrationsYolu, "*.up.sql"))
+	migrationFiles, err := filepath.Glob(filepath.Join(migrationsPath, "*.up.sql"))
 	if err != nil {
 		log.Printf("ERROR: Failed to read migration files from %s: %v", migrationsYolu, err)
 		return fmt.Errorf(i18n.T("error.migrationFileReadFailed", map[string]interface{}{"Error": err}))
@@ -1472,3 +1491,102 @@ func (vy *VeriYonetici) DosyaYoluGorevleriGetir(path string) ([]string, error) {
 	// For now, return empty slice as a placeholder
 	return []string{}, nil
 }
+
+// repairMigrationStateIfNeeded checks if existing tables exist but migration state is missing
+// and repairs the migration state to prevent "table already exists" errors
+func (vy *VeriYonetici) repairMigrationStateIfNeeded() error {
+	log.Printf("DEBUG: Checking if migration state repair is needed")
+
+	// Check if there are any migrations recorded
+	var migrationCount int
+	err := vy.db.QueryRow("SELECT COUNT(*) FROM schema_migrations").Scan(&migrationCount)
+	if err != nil {
+		log.Printf("DEBUG: Could not check migration count: %v", err)
+		return nil // Not critical, continue
+	}
+
+	// If we have migrations recorded, no repair needed
+	if migrationCount > 0 {
+		log.Printf("DEBUG: Found %d recorded migrations, no repair needed", migrationCount)
+		return nil
+	}
+
+	log.Printf("DEBUG: No migrations recorded, checking for existing tables")
+
+	// Check if core tables exist (indicating migrations were run before)
+	tables := []string{"projeler", "gorevler", "baglantilar"}
+	tablesExist := 0
+
+	for _, table := range tables {
+		var exists int
+		query := "SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name=?"
+		err := vy.db.QueryRow(query, table).Scan(&exists)
+		if err == nil && exists > 0 {
+			tablesExist++
+			log.Printf("DEBUG: Table %s exists", table)
+		}
+	}
+
+	// If most core tables exist, repair migration state
+	if tablesExist >= 2 {
+		log.Printf("DEBUG: Found %d core tables, repairing migration state", tablesExist)
+		return vy.repairMigrationState(tablesExist)
+	}
+
+	log.Printf("DEBUG: Only %d core tables exist, normal migration will proceed", tablesExist)
+	return nil
+}
+
+// repairMigrationState adds migration records for already applied migrations
+func (vy *VeriYonetici) repairMigrationState(tablesExist int) error {
+	log.Printf("DEBUG: Starting migration state repair")
+
+	// Define expected migrations based on table existence
+	migrations := []struct {
+		version int
+		tables  []string
+	}{
+		{1, []string{"projeler", "gorevler", "baglantilar", "etiketler", "gorev_etiketleri"}},
+		{2, []string{"gorevler"}}, // due_date column
+		{3, []string{"etiketler", "gorev_etiketleri"}},
+		{4, []string{"gorev_templateleri"}},
+		{5, []string{"gorevler"}}, // parent_id column
+		{6, []string{"ai_interactions", "ai_context", "aktif_proje"}},
+		{7, []string{"baglantilar"}}, // indexes
+		{8, []string{"file_watches", "file_changes"}},
+		{9, []string{"gorev_templateleri"}}, // alias column
+		{10, []string{"gorevler_fts", "filter_profiles", "search_history"}},
+	}
+
+	for _, migration := range migrations {
+		// Check if tables for this migration exist
+		allTablesExist := true
+		for _, table := range migration.tables {
+			var exists int
+			query := "SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name=?"
+			err := vy.db.QueryRow(query, table).Scan(&exists)
+			if err != nil || exists == 0 {
+				allTablesExist = false
+				break
+			}
+		}
+
+		// Special handling for migration 1 - if core tables exist, mark it as applied
+		if migration.version == 1 && tablesExist >= 2 {
+			allTablesExist = true
+		}
+
+		if allTablesExist {
+			// Mark this migration as applied
+			_, err := vy.db.Exec("INSERT OR IGNORE INTO schema_migrations (version) VALUES (?)", migration.version)
+			if err != nil {
+				log.Printf("WARNING: Failed to record migration %d during repair: %v", migration.version, err)
+			} else {
+				log.Printf("DEBUG: Marked migration %d as applied during repair", migration.version)
+			}
+		}
+	}
+
+	log.Printf("DEBUG: Migration state repair completed")
+	return nil
+}