kiro-memory 1.8.1 → 2.1.0

package/plugin/dist/cli/contextkit.js

@@ -324,9 +324,25 @@ function consolidateObservations(db, project, options = {}) {
     ORDER BY cnt DESC
   `).all(project, minGroupSize);
   if (groups.length === 0) return { merged: 0, removed: 0 };
-  let totalMerged = 0;
-  let totalRemoved = 0;
+  if (options.dryRun) {
+    let totalMerged = 0;
+    let totalRemoved = 0;
+    for (const group of groups) {
+      const obsIds = group.ids.split(",").map(Number);
+      const placeholders = obsIds.map(() => "?").join(",");
+      const count = db.query(
+        `SELECT COUNT(*) as cnt FROM observations WHERE id IN (${placeholders})`
+      ).get(...obsIds)?.cnt || 0;
+      if (count >= minGroupSize) {
+        totalMerged += 1;
+        totalRemoved += count - 1;
+      }
+    }
+    return { merged: totalMerged, removed: totalRemoved };
+  }
   const runConsolidation = db.transaction(() => {
+    let merged = 0;
+    let removed = 0;
     for (const group of groups) {
       const obsIds = group.ids.split(",").map(Number);
       const placeholders = obsIds.map(() => "?").join(",");
@@ -334,11 +350,6 @@ function consolidateObservations(db, project, options = {}) {
         `SELECT * FROM observations WHERE id IN (${placeholders}) ORDER BY created_at_epoch DESC`
       ).all(...obsIds);
       if (observations.length < minGroupSize) continue;
-      if (options.dryRun) {
-        totalMerged += 1;
-        totalRemoved += observations.length - 1;
-        continue;
-      }
       const keeper = observations[0];
       const others = observations.slice(1);
       const uniqueTexts = /* @__PURE__ */ new Set();
@@ -351,18 +362,18 @@ function consolidateObservations(db, project, options = {}) {
       const consolidatedText = Array.from(uniqueTexts).join("\n---\n").substring(0, 1e5);
       db.run(
         "UPDATE observations SET text = ?, title = ? WHERE id = ?",
-        [consolidatedText, `[consolidato x${observations.length}] ${keeper.title}`, keeper.id]
+        [consolidatedText, `[consolidated x${observations.length}] ${keeper.title}`, keeper.id]
       );
       const removeIds = others.map((o) => o.id);
       const removePlaceholders = removeIds.map(() => "?").join(",");
       db.run(`DELETE FROM observations WHERE id IN (${removePlaceholders})`, removeIds);
       db.run(`DELETE FROM observation_embeddings WHERE observation_id IN (${removePlaceholders})`, removeIds);
-      totalMerged += 1;
-      totalRemoved += removeIds.length;
+      merged += 1;
+      removed += removeIds.length;
     }
+    return { merged, removed };
   });
-  runConsolidation();
-  return { merged: totalMerged, removed: totalRemoved };
+  return runConsolidation();
 }
 var init_Observations = __esm({
   "src/services/sqlite/Observations.ts"() {
@@ -389,7 +400,7 @@ function escapeLikePattern3(input) {
 }
 function sanitizeFTS5Query(query) {
   const trimmed = query.length > 1e4 ? query.substring(0, 1e4) : query;
-  const terms = trimmed.replace(/[""]/g, "").split(/\s+/).filter((t) => t.length > 0).slice(0, 100).map((t) => `"${t}"`);
+  const terms = trimmed.replace(/[""\u0022]/g, "").split(/\s+/).filter((t) => t.length > 0).slice(0, 100).map((t) => `"${t}"`);
   return terms.join(" ");
 }
 function searchObservationsFTS(db, query, filters = {}) {
@@ -554,26 +565,38 @@ function getTimeline(db, anchorId, depthBefore = 5, depthAfter = 5) {
   return [...before, ...self, ...after];
 }
 function getProjectStats(db, project) {
-  const obsStmt = db.query("SELECT COUNT(*) as count FROM observations WHERE project = ?");
-  const sumStmt = db.query("SELECT COUNT(*) as count FROM summaries WHERE project = ?");
-  const sesStmt = db.query("SELECT COUNT(*) as count FROM sessions WHERE project = ?");
-  const prmStmt = db.query("SELECT COUNT(*) as count FROM prompts WHERE project = ?");
-  const discoveryStmt = db.query(
-    "SELECT COALESCE(SUM(discovery_tokens), 0) as total FROM observations WHERE project = ?"
-  );
-  const discoveryTokens = discoveryStmt.get(project)?.total || 0;
-  const readStmt = db.query(
-    `SELECT COALESCE(SUM(
-      CAST((LENGTH(COALESCE(title, '')) + LENGTH(COALESCE(narrative, ''))) / 4 AS INTEGER)
-    ), 0) as total FROM observations WHERE project = ?`
-  );
-  const readTokens = readStmt.get(project)?.total || 0;
+  const sql = `
+    WITH
+      obs_stats AS (
+        SELECT
+          COUNT(*) as count,
+          COALESCE(SUM(discovery_tokens), 0) as discovery_tokens,
+          COALESCE(SUM(
+            CAST((LENGTH(COALESCE(title, '')) + LENGTH(COALESCE(narrative, ''))) / 4 AS INTEGER)
+          ), 0) as read_tokens
+        FROM observations WHERE project = ?
+      ),
+      sum_count AS (SELECT COUNT(*) as count FROM summaries WHERE project = ?),
+      ses_count AS (SELECT COUNT(*) as count FROM sessions WHERE project = ?),
+      prm_count AS (SELECT COUNT(*) as count FROM prompts WHERE project = ?)
+    SELECT
+      obs_stats.count as observations,
+      obs_stats.discovery_tokens,
+      obs_stats.read_tokens,
+      sum_count.count as summaries,
+      ses_count.count as sessions,
+      prm_count.count as prompts
+    FROM obs_stats, sum_count, ses_count, prm_count
+  `;
+  const row = db.query(sql).get(project, project, project, project);
+  const discoveryTokens = row?.discovery_tokens || 0;
+  const readTokens = row?.read_tokens || 0;
   const savings = Math.max(0, discoveryTokens - readTokens);
   return {
-    observations: obsStmt.get(project)?.count || 0,
-    summaries: sumStmt.get(project)?.count || 0,
-    sessions: sesStmt.get(project)?.count || 0,
-    prompts: prmStmt.get(project)?.count || 0,
+    observations: row?.observations || 0,
+    summaries: row?.summaries || 0,
+    sessions: row?.sessions || 0,
+    prompts: row?.prompts || 0,
     tokenEconomics: { discoveryTokens, readTokens, savings }
   };
 }
@@ -647,8 +670,8 @@ var init_EmbeddingService = __esm({
       initialized = false;
       initializing = null;
       /**
-       * Inizializza il servizio di embedding.
-       * Tenta fastembed, poi @huggingface/transformers, poi fallback a null.
+       * Initialize the embedding service.
+       * Tries fastembed, then @huggingface/transformers, then fallback to null.
        */
       async initialize() {
         if (this.initialized) return this.provider !== null;
@@ -669,11 +692,11 @@ var init_EmbeddingService = __esm({
             });
             this.provider = "fastembed";
             this.initialized = true;
-            logger.info("EMBEDDING", "Inizializzato con fastembed (BGE-small-en-v1.5)");
+            logger.info("EMBEDDING", "Initialized with fastembed (BGE-small-en-v1.5)");
             return true;
           }
         } catch (error) {
-          logger.debug("EMBEDDING", `fastembed non disponibile: ${error}`);
+          logger.debug("EMBEDDING", `fastembed not available: ${error}`);
         }
         try {
           const transformers = await import("@huggingface/transformers");
@@ -684,20 +707,20 @@ var init_EmbeddingService = __esm({
             });
             this.provider = "transformers";
             this.initialized = true;
-            logger.info("EMBEDDING", "Inizializzato con @huggingface/transformers (all-MiniLM-L6-v2)");
+            logger.info("EMBEDDING", "Initialized with @huggingface/transformers (all-MiniLM-L6-v2)");
             return true;
           }
         } catch (error) {
-          logger.debug("EMBEDDING", `@huggingface/transformers non disponibile: ${error}`);
+          logger.debug("EMBEDDING", `@huggingface/transformers not available: ${error}`);
         }
         this.provider = null;
         this.initialized = true;
-        logger.warn("EMBEDDING", "Nessun provider embedding disponibile, ricerca semantica disabilitata");
+        logger.warn("EMBEDDING", "No embedding provider available, semantic search disabled");
         return false;
       }
       /**
-       * Genera embedding per un singolo testo.
-       * Ritorna Float32Array con 384 dimensioni, o null se non disponibile.
+       * Generate embedding for a single text.
+       * Returns Float32Array with 384 dimensions, or null if not available.
        */
       async embed(text) {
         if (!this.initialized) await this.initialize();
@@ -710,46 +733,111 @@ var init_EmbeddingService = __esm({
             return await this._embedTransformers(truncated);
           }
         } catch (error) {
-          logger.error("EMBEDDING", `Errore generazione embedding: ${error}`);
+          logger.error("EMBEDDING", `Error generating embedding: ${error}`);
         }
         return null;
       }
       /**
-       * Genera embeddings in batch.
+       * Generate embeddings in batch.
+       * Uses native batch support when available (fastembed, transformers),
+       * falls back to serial processing on batch failure.
        */
       async embedBatch(texts) {
         if (!this.initialized) await this.initialize();
         if (!this.provider || !this.model) return texts.map(() => null);
-        const results = [];
-        for (const text of texts) {
-          try {
-            const embedding = await this.embed(text);
-            results.push(embedding);
-          } catch {
-            results.push(null);
+        if (texts.length === 0) return [];
+        const truncated = texts.map((t) => t.substring(0, 2e3));
+        try {
+          if (this.provider === "fastembed") {
+            return await this._embedBatchFastembed(truncated);
+          } else if (this.provider === "transformers") {
+            return await this._embedBatchTransformers(truncated);
           }
+        } catch (error) {
+          logger.warn("EMBEDDING", `Batch embedding failed, falling back to serial: ${error}`);
         }
-        return results;
+        return this._embedBatchSerial(truncated);
       }
       /**
-       * Verifica se il servizio è disponibile.
+       * Check if the service is available.
        */
       isAvailable() {
         return this.initialized && this.provider !== null;
       }
       /**
-       * Nome del provider attivo.
+       * Name of the active provider.
        */
       getProvider() {
         return this.provider;
       }
       /**
-       * Dimensioni del vettore embedding.
+       * Embedding vector dimensions.
        */
       getDimensions() {
         return 384;
       }
-      // --- Provider specifici ---
+      // --- Batch implementations ---
+      /**
+       * Native batch embedding with fastembed.
+       * FlagEmbedding.embed() accepts string[] and returns an async iterable of batches.
+       */
+      async _embedBatchFastembed(texts) {
+        const results = [];
+        const embeddings = this.model.embed(texts, texts.length);
+        for await (const batch of embeddings) {
+          if (batch) {
+            for (const vec of batch) {
+              results.push(vec instanceof Float32Array ? vec : new Float32Array(vec));
+            }
+          }
+        }
+        while (results.length < texts.length) {
+          results.push(null);
+        }
+        return results;
+      }
+      /**
+       * Batch embedding with @huggingface/transformers pipeline.
+       * The pipeline accepts string[] and returns a Tensor with shape [N, dims].
+       */
+      async _embedBatchTransformers(texts) {
+        const output = await this.model(texts, {
+          pooling: "mean",
+          normalize: true
+        });
+        if (!output?.data) {
+          return texts.map(() => null);
+        }
+        const dims = this.getDimensions();
+        const data = output.data instanceof Float32Array ? output.data : new Float32Array(output.data);
+        const results = [];
+        for (let i = 0; i < texts.length; i++) {
+          const offset = i * dims;
+          if (offset + dims <= data.length) {
+            results.push(data.slice(offset, offset + dims));
+          } else {
+            results.push(null);
+          }
+        }
+        return results;
+      }
+      /**
+       * Serial fallback: embed texts one at a time.
+       * Used when native batch fails.
+       */
+      async _embedBatchSerial(texts) {
+        const results = [];
+        for (const text of texts) {
+          try {
+            const embedding = await this.embed(text);
+            results.push(embedding);
+          } catch {
+            results.push(null);
+          }
+        }
+        return results;
+      }
+      // --- Single-text provider implementations ---
       async _embedFastembed(text) {
         const embeddings = this.model.embed([text], 1);
         for await (const batch of embeddings) {
@@ -779,14 +867,15 @@ var init_EmbeddingService = __esm({
 import BetterSqlite3 from "better-sqlite3";
 var Database = class {
   _db;
+  _stmtCache = /* @__PURE__ */ new Map();
   constructor(path, options) {
     this._db = new BetterSqlite3(path, {
-      // better-sqlite3 crea il file di default (non serve 'create')
+      // better-sqlite3 creates the file by default ('create' not needed)
       readonly: options?.readwrite === false ? true : false
     });
   }
   /**
-   * Esegui una query SQL senza risultati
+   * Execute a SQL query without results
    */
   run(sql, params) {
     const stmt = this._db.prepare(sql);
@@ -794,51 +883,53 @@ var Database = class {
     return result;
   }
   /**
-   * Prepara una query con interfaccia compatibile bun:sqlite
+   * Prepare a query with bun:sqlite-compatible interface.
+   * Returns a cached prepared statement for repeated queries.
    */
   query(sql) {
-    return new BunQueryCompat(this._db, sql);
+    let cached = this._stmtCache.get(sql);
+    if (!cached) {
+      cached = new BunQueryCompat(this._db, sql);
+      this._stmtCache.set(sql, cached);
+    }
+    return cached;
   }
   /**
-   * Crea una transazione
+   * Create a transaction
    */
   transaction(fn) {
     return this._db.transaction(fn);
   }
   /**
-   * Chiudi la connessione
+   * Close the connection
    */
   close() {
+    this._stmtCache.clear();
     this._db.close();
   }
 };
 var BunQueryCompat = class {
-  _db;
-  _sql;
+  _stmt;
   constructor(db, sql) {
-    this._db = db;
-    this._sql = sql;
+    this._stmt = db.prepare(sql);
   }
   /**
-   * Restituisce tutte le righe
+   * Returns all rows
    */
   all(...params) {
-    const stmt = this._db.prepare(this._sql);
-    return params.length > 0 ? stmt.all(...params) : stmt.all();
+    return params.length > 0 ? this._stmt.all(...params) : this._stmt.all();
   }
   /**
-   * Restituisce la prima riga o null
+   * Returns the first row or null
    */
   get(...params) {
-    const stmt = this._db.prepare(this._sql);
-    return params.length > 0 ? stmt.get(...params) : stmt.get();
+    return params.length > 0 ? this._stmt.get(...params) : this._stmt.get();
   }
   /**
-   * Esegui senza risultati
+   * Execute without results
    */
   run(...params) {
-    const stmt = this._db.prepare(this._sql);
-    return params.length > 0 ? stmt.run(...params) : stmt.run();
+    return params.length > 0 ? this._stmt.run(...params) : this._stmt.run();
   }
 };
 
@@ -881,40 +972,62 @@ init_logger();
 var SQLITE_MMAP_SIZE_BYTES = 256 * 1024 * 1024;
 var SQLITE_CACHE_SIZE_PAGES = 1e4;
 var KiroMemoryDatabase = class {
-  db;
+  _db;
+  /**
+   * Readonly accessor for the underlying Database instance.
+   * Prefer using query() and run() proxy methods directly.
+   */
+  get db() {
+    return this._db;
+  }
   /**
-   * @param dbPath - Percorso al file SQLite (default: DB_PATH)
-   * @param skipMigrations - Se true, salta il migration runner (per hook ad alta frequenza)
+   * @param dbPath - Path to the SQLite file (default: DB_PATH)
+   * @param skipMigrations - If true, skip the migration runner (for high-frequency hooks)
    */
   constructor(dbPath = DB_PATH, skipMigrations = false) {
     if (dbPath !== ":memory:") {
       ensureDir(DATA_DIR);
     }
-    this.db = new Database(dbPath, { create: true, readwrite: true });
-    this.db.run("PRAGMA journal_mode = WAL");
-    this.db.run("PRAGMA synchronous = NORMAL");
-    this.db.run("PRAGMA foreign_keys = ON");
-    this.db.run("PRAGMA temp_store = memory");
-    this.db.run(`PRAGMA mmap_size = ${SQLITE_MMAP_SIZE_BYTES}`);
-    this.db.run(`PRAGMA cache_size = ${SQLITE_CACHE_SIZE_PAGES}`);
+    this._db = new Database(dbPath, { create: true, readwrite: true });
+    this._db.run("PRAGMA journal_mode = WAL");
+    this._db.run("PRAGMA busy_timeout = 5000");
+    this._db.run("PRAGMA synchronous = NORMAL");
+    this._db.run("PRAGMA foreign_keys = ON");
+    this._db.run("PRAGMA temp_store = memory");
+    this._db.run(`PRAGMA mmap_size = ${SQLITE_MMAP_SIZE_BYTES}`);
+    this._db.run(`PRAGMA cache_size = ${SQLITE_CACHE_SIZE_PAGES}`);
     if (!skipMigrations) {
-      const migrationRunner = new MigrationRunner(this.db);
+      const migrationRunner = new MigrationRunner(this._db);
       migrationRunner.runAllMigrations();
     }
   }
   /**
-   * Esegue una funzione all'interno di una transazione atomica.
-   * Se fn() lancia un errore, la transazione viene annullata automaticamente.
+   * Prepare a query (delegates to underlying Database).
+   * Proxy method to avoid ctx.db.db.query() double access.
+   */
+  query(sql) {
+    return this._db.query(sql);
+  }
+  /**
+   * Execute a SQL statement without results (delegates to underlying Database).
+   * Proxy method to avoid ctx.db.db.run() double access.
+   */
+  run(sql, params) {
+    return this._db.run(sql, params);
+  }
+  /**
+   * Executes a function within an atomic transaction.
+   * If fn() throws an error, the transaction is automatically rolled back.
    */
   withTransaction(fn) {
-    const transaction = this.db.transaction(fn);
-    return transaction(this.db);
+    const transaction = this._db.transaction(fn);
+    return transaction(this._db);
   }
   /**
    * Close the database connection
    */
   close() {
-    this.db.close();
+    this._db.close();
   }
 };
 var MigrationRunner = class {
@@ -1408,17 +1521,21 @@ init_EmbeddingService();
 // src/services/search/VectorSearch.ts
 init_EmbeddingService();
 init_logger();
+var DEFAULT_MAX_CANDIDATES = 2e3;
 function cosineSimilarity(a, b) {
-  if (a.length !== b.length) return 0;
+  const len = a.length;
+  if (len !== b.length) return 0;
   let dotProduct = 0;
   let normA = 0;
   let normB = 0;
-  for (let i = 0; i < a.length; i++) {
-    dotProduct += a[i] * b[i];
-    normA += a[i] * a[i];
-    normB += b[i] * b[i];
-  }
-  const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+  for (let i = 0; i < len; i++) {
+    const ai = a[i];
+    const bi = b[i];
+    dotProduct += ai * bi;
+    normA += ai * ai;
+    normB += bi * bi;
+  }
+  const denominator = Math.sqrt(normA * normB);
   if (denominator === 0) return 0;
   return dotProduct / denominator;
 }
@@ -1431,23 +1548,36 @@ function bufferToFloat32(buf) {
 }
 var VectorSearch = class {
   /**
-   * Ricerca semantica: calcola cosine similarity tra query e tutti gli embeddings.
+   * Semantic search with SQL pre-filtering for scalability.
+   *
+   * 2-phase strategy:
+   * 1. SQL pre-filters by project + sorts by recency (loads max N candidates)
+   * 2. JS computes cosine similarity only on filtered candidates
+   *
+   * With 50k observations and maxCandidates=2000, loads only ~4% of data.
    */
   async search(db, queryEmbedding, options = {}) {
     const limit = options.limit || 10;
     const threshold = options.threshold || 0.3;
+    const maxCandidates = options.maxCandidates || DEFAULT_MAX_CANDIDATES;
     try {
-      let sql = `
+      const conditions = [];
+      const params = [];
+      if (options.project) {
+        conditions.push("o.project = ?");
+        params.push(options.project);
+      }
+      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const sql = `
         SELECT e.observation_id, e.embedding,
                o.title, o.text, o.type, o.project, o.created_at, o.created_at_epoch
         FROM observation_embeddings e
         JOIN observations o ON o.id = e.observation_id
+        ${whereClause}
+        ORDER BY o.created_at_epoch DESC
+        LIMIT ?
       `;
-      const params = [];
-      if (options.project) {
-        sql += " WHERE o.project = ?";
-        params.push(options.project);
-      }
+      params.push(maxCandidates);
       const rows = db.query(sql).all(...params);
       const scored = [];
       for (const row of rows) {
@@ -1468,14 +1598,15 @@ var VectorSearch = class {
         }
       }
       scored.sort((a, b) => b.similarity - a.similarity);
+      logger.debug("VECTOR", `Search: ${rows.length} candidates \u2192 ${scored.length} above threshold \u2192 ${Math.min(scored.length, limit)} results`);
       return scored.slice(0, limit);
     } catch (error) {
-      logger.error("VECTOR", `Errore ricerca vettoriale: ${error}`);
+      logger.error("VECTOR", `Vector search error: ${error}`);
       return [];
     }
   }
   /**
-   * Salva embedding per un'osservazione.
+   * Store embedding for an observation.
    */
   async storeEmbedding(db, observationId, embedding, model) {
     try {
@@ -1491,18 +1622,18 @@ var VectorSearch = class {
         embedding.length,
         (/* @__PURE__ */ new Date()).toISOString()
       );
-      logger.debug("VECTOR", `Embedding salvato per osservazione ${observationId}`);
+      logger.debug("VECTOR", `Embedding saved for observation ${observationId}`);
     } catch (error) {
-      logger.error("VECTOR", `Errore salvataggio embedding: ${error}`);
+      logger.error("VECTOR", `Error saving embedding: ${error}`);
     }
   }
   /**
-   * Genera embeddings per osservazioni che non li hanno ancora.
+   * Generate embeddings for observations that don't have them yet.
    */
   async backfillEmbeddings(db, batchSize = 50) {
     const embeddingService2 = getEmbeddingService();
     if (!await embeddingService2.initialize()) {
-      logger.warn("VECTOR", "Embedding service non disponibile, backfill saltato");
+      logger.warn("VECTOR", "Embedding service not available, backfill skipped");
       return 0;
     }
     const rows = db.query(`
@@ -1528,11 +1659,11 @@ var VectorSearch = class {
         count++;
       }
     }
-    logger.info("VECTOR", `Backfill completato: ${count}/${rows.length} embeddings generati`);
+    logger.info("VECTOR", `Backfill completed: ${count}/${rows.length} embeddings generated`);
     return count;
   }
   /**
-   * Statistiche sugli embeddings.
+   * Embedding statistics.
    */
   getStats(db) {
     try {
@@ -1606,21 +1737,21 @@ init_logger();
 var HybridSearch = class {
   embeddingInitialized = false;
   /**
-   * Inizializza il servizio di embedding (lazy, non bloccante)
+   * Initialize the embedding service (lazy, non-blocking)
    */
   async initialize() {
     try {
       const embeddingService2 = getEmbeddingService();
       await embeddingService2.initialize();
       this.embeddingInitialized = embeddingService2.isAvailable();
-      logger.info("SEARCH", `HybridSearch inizializzato (embedding: ${this.embeddingInitialized ? "attivo" : "disattivato"})`);
+      logger.info("SEARCH", `HybridSearch initialized (embedding: ${this.embeddingInitialized ? "active" : "disabled"})`);
     } catch (error) {
-      logger.warn("SEARCH", "Inizializzazione embedding fallita, uso solo FTS5", {}, error);
+      logger.warn("SEARCH", "Embedding initialization failed, using only FTS5", {}, error);
       this.embeddingInitialized = false;
     }
   }
   /**
-   * Ricerca ibrida con scoring a 4 segnali
+   * Hybrid search with 4-signal scoring
    */
   async search(db, query, options = {}) {
     const limit = options.limit || 10;
@@ -1636,7 +1767,7 @@ var HybridSearch = class {
           const vectorResults = await vectorSearch2.search(db, queryEmbedding, {
             project: options.project,
             limit: limit * 2,
-            // Prendiamo piu risultati per il ranking
+            // Fetch more results for ranking
             threshold: 0.3
           });
           for (const hit of vectorResults) {
@@ -1653,10 +1784,10 @@ var HybridSearch = class {
               source: "vector"
             });
           }
-          logger.debug("SEARCH", `Vector search: ${vectorResults.length} risultati`);
+          logger.debug("SEARCH", `Vector search: ${vectorResults.length} results`);
         }
       } catch (error) {
-        logger.warn("SEARCH", "Ricerca vettoriale fallita, uso solo keyword", {}, error);
+        logger.warn("SEARCH", "Vector search failed, using only keyword", {}, error);
       }
     }
     try {
@@ -1686,9 +1817,9 @@ var HybridSearch = class {
           });
         }
       }
-      logger.debug("SEARCH", `Keyword search: ${keywordResults.length} risultati`);
+      logger.debug("SEARCH", `Keyword search: ${keywordResults.length} results`);
     } catch (error) {
-      logger.error("SEARCH", "Ricerca keyword fallita", {}, error);
+      logger.error("SEARCH", "Keyword search failed", {}, error);
     }
     if (rawItems.size === 0) return [];
     const allFTS5Ranks = Array.from(rawItems.values()).filter((item) => item.fts5Rank !== null).map((item) => item.fts5Rank);
@@ -1780,33 +1911,33 @@ var KiroMemorySDK = class {
     };
   }
   /**
-   * Valida input per storeObservation
+   * Validate input for storeObservation
    */
   validateObservationInput(data) {
     if (!data.type || typeof data.type !== "string" || data.type.length > 100) {
-      throw new Error("type \xE8 obbligatorio (stringa, max 100 caratteri)");
+      throw new Error("type is required (string, max 100 chars)");
     }
     if (!data.title || typeof data.title !== "string" || data.title.length > 500) {
-      throw new Error("title \xE8 obbligatorio (stringa, max 500 caratteri)");
+      throw new Error("title is required (string, max 500 chars)");
     }
     if (!data.content || typeof data.content !== "string" || data.content.length > 1e5) {
-      throw new Error("content \xE8 obbligatorio (stringa, max 100KB)");
+      throw new Error("content is required (string, max 100KB)");
     }
   }
   /**
-   * Valida input per storeSummary
+   * Validate input for storeSummary
    */
   validateSummaryInput(data) {
     const MAX = 5e4;
     for (const [key, val] of Object.entries(data)) {
       if (val !== void 0 && val !== null) {
-        if (typeof val !== "string") throw new Error(`${key} deve essere una stringa`);
-        if (val.length > MAX) throw new Error(`${key} troppo grande (max 50KB)`);
+        if (typeof val !== "string") throw new Error(`${key} must be a string`);
+        if (val.length > MAX) throw new Error(`${key} too large (max 50KB)`);
       }
     }
   }
   /**
-   * Genera e salva embedding per un'osservazione (fire-and-forget, non blocca)
+   * Generate and store embedding for an observation (fire-and-forget, non-blocking)
    */
   async generateEmbeddingAsync(observationId, title, content, concepts) {
     try {
@@ -1826,39 +1957,39 @@ var KiroMemorySDK = class {
         );
       }
     } catch (error) {
-      logger.debug("SDK", `Embedding generation fallita per obs ${observationId}: ${error}`);
+      logger.debug("SDK", `Embedding generation failed for obs ${observationId}: ${error}`);
     }
   }
   /**
-   * Genera content hash SHA256 per deduplicazione basata su contenuto.
-   * Usa (project + type + title + narrative) come tupla di identità semantica.
-   * NON include sessionId perché è unico ad ogni invocazione.
+   * Generate SHA256 content hash for content-based deduplication.
+   * Uses (project + type + title + narrative) as semantic identity tuple.
+   * Does NOT include sessionId since it's unique per invocation.
    */
   generateContentHash(type, title, narrative) {
     const payload = `${this.project}|${type}|${title}|${narrative || ""}`;
     return createHash("sha256").update(payload).digest("hex");
   }
   /**
-   * Finestre di deduplicazione per tipo (ms).
-   * Tipi con molte ripetizioni hanno finestre più ampie.
+   * Deduplication windows per type (ms).
+   * Types with many repetitions have wider windows.
    */
   getDeduplicationWindow(type) {
     switch (type) {
       case "file-read":
         return 6e4;
-      // 60s — letture frequenti sugli stessi file
+      // 60s — frequent reads on the same files
       case "file-write":
         return 1e4;
-      // 10s — scritture rapide consecutive
+      // 10s — rapid consecutive writes
       case "command":
         return 3e4;
       // 30s — standard
       case "research":
         return 12e4;
-      // 120s — web search e fetch ripetuti
+      // 120s — repeated web search and fetch
       case "delegation":
         return 6e4;
-      // 60s — delegazioni rapide
+      // 60s — rapid delegations
       default:
         return 3e4;
     }
@@ -1872,7 +2003,7 @@ var KiroMemorySDK = class {
     const contentHash = this.generateContentHash(data.type, data.title, data.narrative);
     const dedupWindow = this.getDeduplicationWindow(data.type);
     if (isDuplicateObservation(this.db.db, contentHash, dedupWindow)) {
-      logger.debug("SDK", `Osservazione duplicata scartata (${data.type}, ${dedupWindow}ms): ${data.title}`);
+      logger.debug("SDK", `Duplicate observation discarded (${data.type}, ${dedupWindow}ms): ${data.title}`);
       return -1;
     }
     const filesRead = data.filesRead || (data.type === "file-read" ? data.files : void 0);
@@ -1900,12 +2031,12 @@ var KiroMemorySDK = class {
     return observationId;
   }
   /**
-   * Salva conoscenza strutturata (constraint, decision, heuristic, rejected).
-   * Usa il campo `type` per il knowledgeType e `facts` per i metadati JSON.
+   * Store structured knowledge (constraint, decision, heuristic, rejected).
+   * Uses the `type` field for knowledgeType and `facts` for JSON metadata.
    */
   async storeKnowledge(data) {
     if (!KNOWLEDGE_TYPES.includes(data.knowledgeType)) {
-      throw new Error(`knowledgeType non valido: ${data.knowledgeType}. Valori ammessi: ${KNOWLEDGE_TYPES.join(", ")}`);
+      throw new Error(`Invalid knowledgeType: ${data.knowledgeType}. Allowed values: ${KNOWLEDGE_TYPES.join(", ")}`);
     }
     this.validateObservationInput({ type: data.knowledgeType, title: data.title, content: data.content });
     const metadata = (() => {
@@ -1937,9 +2068,9 @@ var KiroMemorySDK = class {
       }
     })();
     const sessionId = "sdk-" + Date.now();
-    const contentHash = this.generateContentHash(data.type, data.title);
+    const contentHash = this.generateContentHash(data.knowledgeType, data.title);
     if (isDuplicateObservation(this.db.db, contentHash)) {
-      logger.debug("SDK", `Knowledge duplicata scartata: ${data.title}`);
+      logger.debug("SDK", `Duplicate knowledge discarded: ${data.title}`);
       return -1;
     }
     const discoveryTokens = Math.ceil(data.content.length / 4);
@@ -1956,11 +2087,11 @@ var KiroMemorySDK = class {
       null,
       // narrative
       JSON.stringify(metadata),
-      // facts = metadati JSON
+      // facts = JSON metadata
       data.concepts?.join(", ") || null,
       data.files?.join(", ") || null,
       null,
-      // filesModified: knowledge non modifica file
+      // filesModified: knowledge doesn't modify files
       0,
       // prompt_number
       contentHash,
@@ -2071,8 +2202,8 @@ var KiroMemorySDK = class {
     return this.project;
   }
   /**
-   * Ricerca ibrida: vector search + keyword FTS5
-   * Richiede inizializzazione HybridSearch (embedding service)
+   * Hybrid search: vector search + keyword FTS5
+   * Requires HybridSearch initialization (embedding service)
    */
   async hybridSearch(query, options = {}) {
     const hybridSearch2 = getHybridSearch();
@@ -2082,8 +2213,8 @@ var KiroMemorySDK = class {
     });
   }
   /**
-   * Ricerca solo semantica (vector search)
-   * Ritorna risultati basati su similarità coseno con gli embeddings
+   * Semantic-only search (vector search)
+   * Returns results based on cosine similarity with embeddings
    */
   async semanticSearch(query, options = {}) {
     const embeddingService2 = getEmbeddingService();
@@ -2118,21 +2249,21 @@ var KiroMemorySDK = class {
     }));
   }
   /**
-   * Genera embeddings per osservazioni che non li hanno ancora
+   * Generate embeddings for observations that don't have them yet
    */
   async backfillEmbeddings(batchSize = 50) {
     const vectorSearch2 = getVectorSearch();
     return vectorSearch2.backfillEmbeddings(this.db.db, batchSize);
   }
   /**
-   * Statistiche sugli embeddings nel database
+   * Embedding statistics in the database
    */
   getEmbeddingStats() {
     const vectorSearch2 = getVectorSearch();
     return vectorSearch2.getStats(this.db.db);
   }
   /**
-   * Inizializza il servizio di embedding (lazy, chiamare prima di hybridSearch)
+   * Initialize the embedding service (lazy, call before hybridSearch)
    */
   async initializeEmbeddings() {
     const hybridSearch2 = getHybridSearch();
@@ -2140,10 +2271,10 @@ var KiroMemorySDK = class {
     return getEmbeddingService().isAvailable();
   }
   /**
-   * Contesto smart con ranking a 4 segnali e budget token.
+   * Smart context with 4-signal ranking and token budget.
    *
-   * Se query presente: usa HybridSearch con SEARCH_WEIGHTS.
-   * Se senza query: ranking per recency + project match (CONTEXT_WEIGHTS).
+   * If query present: uses HybridSearch with SEARCH_WEIGHTS.
+   * If no query: ranking by recency + project match (CONTEXT_WEIGHTS).
    */
   async getSmartContext(options = {}) {
     const tokenBudget = options.tokenBudget || parseInt(process.env.KIRO_MEMORY_CONTEXT_TOKENS || "0", 10) || 2e3;
@@ -2217,8 +2348,8 @@ var KiroMemorySDK = class {
     };
   }
   /**
-   * Rileva osservazioni stale (file modificati dopo la creazione) e le marca nel DB.
-   * Ritorna il numero di osservazioni marcate come stale.
+   * Detect stale observations (files modified after creation) and mark them in DB.
+   * Returns the number of observations marked as stale.
    */
   async detectStaleObservations() {
     const staleObs = getStaleObservations(this.db.db, this.project);
@@ -2229,14 +2360,14 @@ var KiroMemorySDK = class {
     return staleObs.length;
   }
   /**
-   * Consolida osservazioni duplicate sullo stesso file e tipo.
-   * Raggruppa per (project, type, files_modified), mantiene la piu recente.
+   * Consolidate duplicate observations on the same file and type.
+   * Groups by (project, type, files_modified), keeps the most recent.
    */
   async consolidateObservations(options = {}) {
     return consolidateObservations(this.db.db, this.project, options);
   }
   /**
-   * Statistiche decay: totale, stale, mai accedute, accedute di recente.
+   * Decay statistics: total, stale, never accessed, recently accessed.
    */
   async getDecayStats() {
     const total = this.db.db.query(
@@ -2255,8 +2386,8 @@ var KiroMemorySDK = class {
     return { total, stale, neverAccessed, recentlyAccessed };
   }
   /**
-   * Crea un checkpoint strutturato per resume sessione.
-   * Salva automaticamente un context_snapshot con le ultime 10 osservazioni.
+   * Create a structured checkpoint for session resume.
+   * Automatically saves a context_snapshot with the last 10 observations.
    */
   async createCheckpoint(sessionId, data) {
     const recentObs = getObservationsByProject(this.db.db, this.project, 10);
@@ -2273,21 +2404,21 @@ var KiroMemorySDK = class {
     });
   }
   /**
-   * Recupera l'ultimo checkpoint di una sessione specifica.
+   * Retrieve the latest checkpoint of a specific session.
    */
   async getCheckpoint(sessionId) {
     return getLatestCheckpoint(this.db.db, sessionId);
   }
   /**
-   * Recupera l'ultimo checkpoint per il progetto corrente.
-   * Utile per resume automatico senza specificare session ID.
+   * Retrieve the latest checkpoint for the current project.
+   * Useful for automatic resume without specifying session ID.
    */
   async getLatestProjectCheckpoint() {
     return getLatestCheckpointByProject(this.db.db, this.project);
   }
   /**
-   * Genera un report di attività per il progetto corrente.
-   * Aggrega osservazioni, sessioni, summaries e file per un periodo temporale.
+   * Generate an activity report for the current project.
+   * Aggregates observations, sessions, summaries and files for a time period.
    */
   async generateReport(options) {
     const now = /* @__PURE__ */ new Date();
@@ -2483,6 +2614,71 @@ function formatReportJson(data) {
   return JSON.stringify(data, null, 2);
 }
 
+// src/cli/banner.ts
+var G = [
+  "\x1B[38;5;135m",
+  // viola
+  "\x1B[38;5;99m",
+  // viola-blu
+  "\x1B[38;5;63m",
+  // indaco
+  "\x1B[38;5;33m",
+  // blu
+  "\x1B[38;5;39m",
+  // blu chiaro
+  "\x1B[38;5;44m"
+  // ciano
+];
+var R = "\x1B[0m";
+var B = "\x1B[1m";
+var D = "\x1B[2m";
+var U = "\x1B[4m";
+var GRN = "\x1B[32m";
+var CYN = "\x1B[36m";
+var LOGO = [
+  " \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
+  " \u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557",
+  " \u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551",
+  " \u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551",
+  " \u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
+  " \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D"
+];
+var MEMORY_TAG = "          M E M O R Y";
+var LINE = "\u2500".repeat(48);
+function supportsColor() {
+  if (process.env.NO_COLOR || process.env.TERM === "dumb") return false;
+  return process.stdout.isTTY ?? false;
+}
+function printBanner(opts) {
+  const color = supportsColor();
+  const c = (code, text) => color ? `${code}${text}${R}` : text;
+  console.log("");
+  for (let i = 0; i < LOGO.length; i++) {
+    console.log(`  ${c(G[i], LOGO[i])}`);
+  }
+  console.log(`  ${c(`${G[G.length - 1]}${B}`, MEMORY_TAG)}`);
+  console.log("");
+  console.log(`  ${c(D, LINE)}`);
+  console.log("");
+  console.log(`  ${c(`${GRN}${B}`, "\u2713 Installation complete!")}  v${opts.version}`);
+  console.log(`  ${c(D, `Editor: ${opts.editor}`)}`);
+  console.log("");
+  console.log(`  ${c(`${CYN}${B}`, "Installed:")}`);
+  for (const p of opts.configPaths) {
+    console.log(`    ${c(D, "\u2192")} ${p}`);
+  }
+  console.log(`    ${c(D, "\u2192")} Data: ${opts.dataDir}`);
+  console.log("");
+  console.log(`  ${c(`${CYN}${B}`, "Dashboard:")}  ${c(U, opts.dashboardUrl)}`);
+  console.log(`  ${c(D, "Docs:       https://auritidesign.it/docs/kiro-memory/")}`);
+  console.log("");
+  console.log(`  ${c(D, LINE)}`);
+  console.log(`  ${c(G[2], "Your AI assistant now has persistent memory.")}`);
+  console.log(`  ${c(G[3], "Every session builds on the last.")}`);
+  console.log(`  ${c(D, LINE)}`);
+  console.log("");
+}
+
 // src/cli/contextkit.ts
 import { execSync } from "child_process";
 import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync, appendFileSync as appendFileSync2 } from "fs";
@@ -2495,6 +2691,12 @@ var command = args[0];
 var __filename = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname2(__filename);
 var DIST_DIR = dirname2(__dirname2);
+var PKG_VERSION = "unknown";
+try {
+  const pkgPath = join3(DIST_DIR, "..", "..", "package.json");
+  PKG_VERSION = JSON.parse(readFileSync2(pkgPath, "utf8")).version;
+} catch {
+}
 var AGENT_TEMPLATE = JSON.stringify({
   name: "kiro-memory",
   description: "Agent with persistent cross-session memory. Uses Kiro Memory to remember context from previous sessions and automatically save what it learns.",
@@ -2917,17 +3119,23 @@ ${aliasLine}
     }
   }
   console.log("\n[4/4] Done!\n");
-  console.log("  \x1B[32m\u2550\u2550\u2550 Installation complete! \u2550\u2550\u2550\x1B[0m\n");
+  printBanner({
+    editor: "Kiro CLI",
+    version: PKG_VERSION,
+    dashboardUrl: "http://localhost:3001",
+    dataDir,
+    configPaths: [
+      `Agent:    ${agentDestPath}`,
+      `MCP:      ${mcpFilePath}`,
+      `Steering: ${steeringDestPath}`
+    ]
+  });
   console.log("  Start Kiro with memory:");
   if (aliasAlreadySet) {
-    console.log("    \x1B[1mkiro\x1B[0m");
+    console.log("    \x1B[1mkiro\x1B[0m\n");
   } else {
-    console.log("    \x1B[1mkiro-cli --agent kiro-memory\x1B[0m");
+    console.log("    \x1B[1mkiro-cli --agent kiro-memory\x1B[0m\n");
   }
-  console.log("");
-  console.log("  The worker starts automatically when a Kiro session begins.");
-  console.log(`  Web dashboard: \x1B[4mhttp://localhost:3001\x1B[0m
-`);
 }
 var CLAUDE_CODE_STEERING = `# Kiro Memory - Persistent Cross-Session Memory
 
@@ -3052,12 +3260,17 @@ async function installClaudeCode() {
   }
   console.log(`  \u2192 Data dir:     ${dataDir}`);
   console.log("\n[3/3] Done!\n");
-  console.log("  \x1B[32m\u2550\u2550\u2550 Claude Code integration complete! \u2550\u2550\u2550\x1B[0m\n");
-  console.log("  Memory hooks are now active for Claude Code.");
-  console.log("  Start a new Claude Code session to begin tracking context.\n");
-  console.log("  The worker starts automatically on first session.");
-  console.log(`  Web dashboard: \x1B[4mhttp://localhost:3001\x1B[0m
-`);
+  printBanner({
+    editor: "Claude Code",
+    version: PKG_VERSION,
+    dashboardUrl: "http://localhost:3001",
+    dataDir,
+    configPaths: [
+      `Hooks:    ${settingsPath}`,
+      `MCP:      ${mcpPath}`,
+      `Steering: ${steeringPath}`
+    ]
+  });
 }
 async function installCursor() {
   console.log("\n=== Kiro Memory - Cursor Installation ===\n");
@@ -3139,12 +3352,16 @@ async function installCursor() {
   console.log(`  \u2192 MCP config:   ${mcpPath}`);
   console.log(`  \u2192 Data dir:     ${dataDir}`);
   console.log("\n[3/3] Done!\n");
-  console.log("  \x1B[32m\u2550\u2550\u2550 Cursor integration complete! \u2550\u2550\u2550\x1B[0m\n");
-  console.log("  Memory hooks are now active for Cursor IDE.");
-  console.log("  Start a new Cursor Agent session to begin tracking context.\n");
-  console.log("  The worker starts automatically on first session.");
-  console.log(`  Web dashboard: \x1B[4mhttp://localhost:3001\x1B[0m
-`);
+  printBanner({
+    editor: "Cursor",
+    version: PKG_VERSION,
+    dashboardUrl: "http://localhost:3001",
+    dataDir,
+    configPaths: [
+      `Hooks: ${hooksPath}`,
+      `MCP:   ${mcpPath}`
+    ]
+  });
 }
 async function installWindsurf() {
   console.log("\n=== Kiro Memory - Windsurf Installation ===\n");
@@ -3193,12 +3410,15 @@ async function installWindsurf() {
   console.log(`  \u2192 MCP config:   ${mcpPath}`);
   console.log(`  \u2192 Data dir:     ${dataDir}`);
   console.log("\n[3/3] Done!\n");
-  console.log("  \x1B[32m\u2550\u2550\u2550 Windsurf integration complete! \u2550\u2550\u2550\x1B[0m\n");
-  console.log("  Kiro Memory MCP server is now registered for Windsurf.");
-  console.log("  Restart Windsurf to activate the MCP server.\n");
-  console.log("  The worker starts automatically on first use.");
-  console.log(`  Web dashboard: \x1B[4mhttp://localhost:3001\x1B[0m
-`);
+  printBanner({
+    editor: "Windsurf",
+    version: PKG_VERSION,
+    dashboardUrl: "http://localhost:3001",
+    dataDir,
+    configPaths: [
+      `MCP: ${mcpPath}`
+    ]
+  });
   console.log("  \x1B[2mTip: Add a .windsurfrules file to your project with instructions");
   console.log("  to use the kiro-memory MCP tools for persistent context.\x1B[0m\n");
 }
@@ -3255,12 +3475,15 @@ async function installCline() {
   console.log(`  \u2192 MCP config:   ${mcpPath}`);
   console.log(`  \u2192 Data dir:     ${dataDir}`);
   console.log("\n[3/3] Done!\n");
-  console.log("  \x1B[32m\u2550\u2550\u2550 Cline integration complete! \u2550\u2550\u2550\x1B[0m\n");
-  console.log("  Kiro Memory MCP server is now registered for Cline.");
-  console.log("  Restart VS Code to activate the MCP server in Cline.\n");
-  console.log("  The worker starts automatically on first use.");
-  console.log(`  Web dashboard: \x1B[4mhttp://localhost:3001\x1B[0m
-`);
+  printBanner({
+    editor: "Cline",
+    version: PKG_VERSION,
+    dashboardUrl: "http://localhost:3001",
+    dataDir,
+    configPaths: [
+      `MCP: ${mcpPath}`
+    ]
+  });
   console.log("  \x1B[2mTip: Add a .clinerules file to your project with instructions");
   console.log("  to use the kiro-memory MCP tools for persistent context.\x1B[0m\n");
 }
@@ -3322,13 +3545,13 @@ async function runDoctor() {
   checks.push({
     name: "Claude Code hooks",
     ok: true,
-    // Non-blocking: installazione opzionale
+    // Non-blocking: optional installation
     message: claudeHooksOk ? "Configured in ~/.claude/settings.json" : "Not configured (optional: run kiro-memory install --claude-code)"
   });
   checks.push({
     name: "Claude Code MCP",
     ok: true,
-    // Non-blocking: installazione opzionale
+    // Non-blocking: optional installation
     message: claudeMcpOk ? "kiro-memory registered in ~/.mcp.json" : "Not configured (optional: run kiro-memory install --claude-code)"
   });
   const cursorDir = join3(homedir3(), ".cursor");
@@ -3357,13 +3580,13 @@ async function runDoctor() {
   checks.push({
     name: "Cursor hooks",
     ok: true,
-    // Non-blocking: installazione opzionale
+    // Non-blocking: optional installation
     message: cursorHooksOk ? "Configured in ~/.cursor/hooks.json" : "Not configured (optional: run kiro-memory install --cursor)"
   });
   checks.push({
     name: "Cursor MCP",
     ok: true,
-    // Non-blocking: installazione opzionale
+    // Non-blocking: optional installation
     message: cursorMcpOk ? "kiro-memory registered in ~/.cursor/mcp.json" : "Not configured (optional: run kiro-memory install --cursor)"
   });
   const windsurfMcpPath = join3(homedir3(), ".codeium", "windsurf", "mcp_config.json");
@@ -3378,7 +3601,7 @@ async function runDoctor() {
   checks.push({
     name: "Windsurf MCP",
     ok: true,
-    // Non-blocking: installazione opzionale
+    // Non-blocking: optional installation
     message: windsurfMcpOk ? "kiro-memory registered in ~/.codeium/windsurf/mcp_config.json" : "Not configured (optional: run kiro-memory install --windsurf)"
   });
   const clinePlatform = process.platform;
@@ -3400,7 +3623,7 @@ async function runDoctor() {
   checks.push({
     name: "Cline MCP",
     ok: true,
-    // Non-blocking: installazione opzionale
+    // Non-blocking: optional installation
     message: clineMcpOk ? `kiro-memory registered in cline_mcp_settings.json` : "Not configured (optional: run kiro-memory install --cline)"
   });
   let workerOk = false;