k0ntext 3.6.0 → 3.8.0

package/src/db/migrations/files/0015_add_sync_state_version_tracking.sql

@@ -0,0 +1,18 @@
+-- Migration: 1.5.0
+-- Description: Add version tracking columns to sync_state table
+-- Breaks: false
+-- Dependencies: 1.4.0
+
+-- Add k0ntext_version column to track package version when sync occurred
+-- Note: Existing rows will have NULL for this column
+ALTER TABLE sync_state ADD COLUMN k0ntext_version TEXT;
+
+-- Add user_modified flag to track if user manually edited the synced file
+ALTER TABLE sync_state ADD COLUMN user_modified INTEGER DEFAULT 0;
+
+-- Add last_checked timestamp for version checking (ISO 8601 format)
+ALTER TABLE sync_state ADD COLUMN last_checked TEXT;
+
+-- Create indexes for efficient queries
+CREATE INDEX IF NOT EXISTS idx_sync_state_version ON sync_state(k0ntext_version);
+CREATE INDEX IF NOT EXISTS idx_sync_state_user_modified ON sync_state(user_modified);

package/src/db/schema.ts

@@ -5,7 +5,7 @@
  * Supports vector embeddings, knowledge graph, and sync state.
  */
 
-export const SCHEMA_VERSION = '1.4.0';
+export const SCHEMA_VERSION = '1.6.0';
 
 /**
  * Core database schema SQL

package/src/embeddings/openrouter.ts

@@ -1,12 +1,13 @@
 /**
  * OpenRouter Client
- * 
+ *
  * Client for OpenRouter API supporting both embeddings and chat completions.
  * Used for intelligent initialization and context understanding.
  */
 
 import { createHash } from 'crypto';
 import { K0NTEXT_MODELS, MODEL_CONFIG, getPrimaryChatModel, getEmbeddingModel } from '../config/models.js';
+import { stripBOM } from '../utils/encoding.js';
 
 /**
  * OpenRouter API endpoints
@@ -185,7 +186,8 @@ export class OpenRouterClient {
       throw new Error('OPENROUTER_API_KEY is required');
     }
 
-    this.apiKey = config.apiKey;
+    // Strip UTF-8 BOM if present (Windows editors sometimes add this to .env files)
+    this.apiKey = stripBOM(config.apiKey);
     this.embeddingModel = config.embeddingModel || DEFAULT_EMBEDDING_MODEL;
     this.chatModel = config.chatModel || DEFAULT_CHAT_MODEL;
     this.siteUrl = config.siteUrl || 'https://github.com/SireJeff/claude-context-engineering-template';
@@ -582,8 +584,11 @@ export function createOpenRouterClient(): OpenRouterClient {
     );
   }
 
+  // Strip UTF-8 BOM from API key (Windows editors sometimes add this to .env files)
+  const cleanApiKey = stripBOM(apiKey);
+
   return new OpenRouterClient({
-    apiKey,
+    apiKey: cleanApiKey,
     // Use centralized models from config, allow env override for testing
     embeddingModel: process.env.OPENROUTER_EMBEDDING_MODEL || getEmbeddingModel(),
     chatModel: process.env.OPENROUTER_CHAT_MODEL || getPrimaryChatModel()
@@ -594,7 +599,8 @@ export function createOpenRouterClient(): OpenRouterClient {
  * Check if OpenRouter API key is available
  */
 export function hasOpenRouterKey(): boolean {
-  return !!process.env.OPENROUTER_API_KEY;
+  const apiKey = process.env.OPENROUTER_API_KEY;
+  return !!apiKey && stripBOM(apiKey).length > 0;
 }
 
 /**