kiro-memory 1.6.0 → 1.7.0

package/plugin/dist/hooks/agentSpawn.js

@@ -1,15 +1,433 @@
 #!/usr/bin/env node
 import { createRequire } from 'module';const require = createRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/services/sqlite/Observations.ts
+var Observations_exports = {};
+__export(Observations_exports, {
+  consolidateObservations: () => consolidateObservations,
+  createObservation: () => createObservation,
+  deleteObservation: () => deleteObservation,
+  getObservationsByProject: () => getObservationsByProject,
+  getObservationsBySession: () => getObservationsBySession,
+  searchObservations: () => searchObservations,
+  updateLastAccessed: () => updateLastAccessed
+});
+function escapeLikePattern(input) {
+  return input.replace(/[%_\\]/g, "\\$&");
+}
+function createObservation(db, memorySessionId, project, type, title, subtitle, text, narrative, facts, concepts, filesRead, filesModified, promptNumber) {
+  const now = /* @__PURE__ */ new Date();
+  const result = db.run(
+    `INSERT INTO observations 
+     (memory_session_id, project, type, title, subtitle, text, narrative, facts, concepts, files_read, files_modified, prompt_number, created_at, created_at_epoch)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    [memorySessionId, project, type, title, subtitle, text, narrative, facts, concepts, filesRead, filesModified, promptNumber, now.toISOString(), now.getTime()]
+  );
+  return Number(result.lastInsertRowid);
+}
+function getObservationsBySession(db, memorySessionId) {
+  const query = db.query(
+    "SELECT * FROM observations WHERE memory_session_id = ? ORDER BY prompt_number ASC"
+  );
+  return query.all(memorySessionId);
+}
+function getObservationsByProject(db, project, limit = 100) {
+  const query = db.query(
+    "SELECT * FROM observations WHERE project = ? ORDER BY created_at_epoch DESC LIMIT ?"
+  );
+  return query.all(project, limit);
+}
+function searchObservations(db, searchTerm, project) {
+  const sql = project ? `SELECT * FROM observations
+       WHERE project = ? AND (title LIKE ? ESCAPE '\\' OR text LIKE ? ESCAPE '\\' OR narrative LIKE ? ESCAPE '\\')
+       ORDER BY created_at_epoch DESC` : `SELECT * FROM observations
+       WHERE title LIKE ? ESCAPE '\\' OR text LIKE ? ESCAPE '\\' OR narrative LIKE ? ESCAPE '\\'
+       ORDER BY created_at_epoch DESC`;
+  const pattern = `%${escapeLikePattern(searchTerm)}%`;
+  const query = db.query(sql);
+  if (project) {
+    return query.all(project, pattern, pattern, pattern);
+  }
+  return query.all(pattern, pattern, pattern);
+}
+function deleteObservation(db, id) {
+  db.run("DELETE FROM observations WHERE id = ?", [id]);
+}
+function updateLastAccessed(db, ids) {
+  if (!Array.isArray(ids) || ids.length === 0) return;
+  const validIds = ids.filter((id) => typeof id === "number" && Number.isInteger(id) && id > 0).slice(0, 500);
+  if (validIds.length === 0) return;
+  const now = Date.now();
+  const placeholders = validIds.map(() => "?").join(",");
+  db.run(
+    `UPDATE observations SET last_accessed_epoch = ? WHERE id IN (${placeholders})`,
+    [now, ...validIds]
+  );
+}
+function consolidateObservations(db, project, options = {}) {
+  const minGroupSize = options.minGroupSize || 3;
+  const groups = db.query(`
+    SELECT type, files_modified, COUNT(*) as cnt, GROUP_CONCAT(id) as ids
+    FROM observations
+    WHERE project = ? AND files_modified IS NOT NULL AND files_modified != ''
+    GROUP BY type, files_modified
+    HAVING cnt >= ?
+    ORDER BY cnt DESC
+  `).all(project, minGroupSize);
+  if (groups.length === 0) return { merged: 0, removed: 0 };
+  let totalMerged = 0;
+  let totalRemoved = 0;
+  for (const group of groups) {
+    const obsIds = group.ids.split(",").map(Number);
+    const placeholders = obsIds.map(() => "?").join(",");
+    const observations = db.query(
+      `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();
+    if (keeper.text) uniqueTexts.add(keeper.text);
+    for (const obs of others) {
+      if (obs.text && !uniqueTexts.has(obs.text)) {
+        uniqueTexts.add(obs.text);
+      }
+    }
+    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]
+    );
+    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;
+  }
+  return { merged: totalMerged, removed: totalRemoved };
+}
+var init_Observations = __esm({
+  "src/services/sqlite/Observations.ts"() {
+    "use strict";
+  }
+});
+
+// src/services/sqlite/Search.ts
+var Search_exports = {};
+__export(Search_exports, {
+  getObservationsByIds: () => getObservationsByIds,
+  getProjectStats: () => getProjectStats,
+  getStaleObservations: () => getStaleObservations,
+  getTimeline: () => getTimeline,
+  markObservationsStale: () => markObservationsStale,
+  searchObservationsFTS: () => searchObservationsFTS,
+  searchObservationsFTSWithRank: () => searchObservationsFTSWithRank,
+  searchObservationsLIKE: () => searchObservationsLIKE,
+  searchSummariesFiltered: () => searchSummariesFiltered
+});
+import { existsSync as existsSync4, statSync } from "fs";
+function escapeLikePattern3(input) {
+  return input.replace(/[%_\\]/g, "\\$&");
+}
+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}"`);
+  return terms.join(" ");
+}
+function searchObservationsFTS(db, query, filters = {}) {
+  const limit = filters.limit || 50;
+  try {
+    const safeQuery = sanitizeFTS5Query(query);
+    if (!safeQuery) return searchObservationsLIKE(db, query, filters);
+    let sql = `
+      SELECT o.* FROM observations o
+      JOIN observations_fts fts ON o.id = fts.rowid
+      WHERE observations_fts MATCH ?
+    `;
+    const params = [safeQuery];
+    if (filters.project) {
+      sql += " AND o.project = ?";
+      params.push(filters.project);
+    }
+    if (filters.type) {
+      sql += " AND o.type = ?";
+      params.push(filters.type);
+    }
+    if (filters.dateStart) {
+      sql += " AND o.created_at_epoch >= ?";
+      params.push(filters.dateStart);
+    }
+    if (filters.dateEnd) {
+      sql += " AND o.created_at_epoch <= ?";
+      params.push(filters.dateEnd);
+    }
+    sql += " ORDER BY rank LIMIT ?";
+    params.push(limit);
+    const stmt = db.query(sql);
+    return stmt.all(...params);
+  } catch {
+    return searchObservationsLIKE(db, query, filters);
+  }
+}
+function searchObservationsFTSWithRank(db, query, filters = {}) {
+  const limit = filters.limit || 50;
+  try {
+    const safeQuery = sanitizeFTS5Query(query);
+    if (!safeQuery) return [];
+    let sql = `
+      SELECT o.*, rank as fts5_rank FROM observations o
+      JOIN observations_fts fts ON o.id = fts.rowid
+      WHERE observations_fts MATCH ?
+    `;
+    const params = [safeQuery];
+    if (filters.project) {
+      sql += " AND o.project = ?";
+      params.push(filters.project);
+    }
+    if (filters.type) {
+      sql += " AND o.type = ?";
+      params.push(filters.type);
+    }
+    if (filters.dateStart) {
+      sql += " AND o.created_at_epoch >= ?";
+      params.push(filters.dateStart);
+    }
+    if (filters.dateEnd) {
+      sql += " AND o.created_at_epoch <= ?";
+      params.push(filters.dateEnd);
+    }
+    sql += " ORDER BY rank LIMIT ?";
+    params.push(limit);
+    const stmt = db.query(sql);
+    return stmt.all(...params);
+  } catch {
+    return [];
+  }
+}
+function searchObservationsLIKE(db, query, filters = {}) {
+  const limit = filters.limit || 50;
+  const pattern = `%${escapeLikePattern3(query)}%`;
+  let sql = `
+    SELECT * FROM observations
+    WHERE (title LIKE ? ESCAPE '\\' OR text LIKE ? ESCAPE '\\' OR narrative LIKE ? ESCAPE '\\' OR concepts LIKE ? ESCAPE '\\')
+  `;
+  const params = [pattern, pattern, pattern, pattern];
+  if (filters.project) {
+    sql += " AND project = ?";
+    params.push(filters.project);
+  }
+  if (filters.type) {
+    sql += " AND type = ?";
+    params.push(filters.type);
+  }
+  if (filters.dateStart) {
+    sql += " AND created_at_epoch >= ?";
+    params.push(filters.dateStart);
+  }
+  if (filters.dateEnd) {
+    sql += " AND created_at_epoch <= ?";
+    params.push(filters.dateEnd);
+  }
+  sql += " ORDER BY created_at_epoch DESC LIMIT ?";
+  params.push(limit);
+  const stmt = db.query(sql);
+  return stmt.all(...params);
+}
+function searchSummariesFiltered(db, query, filters = {}) {
+  const limit = filters.limit || 20;
+  const pattern = `%${escapeLikePattern3(query)}%`;
+  let sql = `
+    SELECT * FROM summaries
+    WHERE (request LIKE ? ESCAPE '\\' OR learned LIKE ? ESCAPE '\\' OR completed LIKE ? ESCAPE '\\' OR notes LIKE ? ESCAPE '\\' OR next_steps LIKE ? ESCAPE '\\')
+  `;
+  const params = [pattern, pattern, pattern, pattern, pattern];
+  if (filters.project) {
+    sql += " AND project = ?";
+    params.push(filters.project);
+  }
+  if (filters.dateStart) {
+    sql += " AND created_at_epoch >= ?";
+    params.push(filters.dateStart);
+  }
+  if (filters.dateEnd) {
+    sql += " AND created_at_epoch <= ?";
+    params.push(filters.dateEnd);
+  }
+  sql += " ORDER BY created_at_epoch DESC LIMIT ?";
+  params.push(limit);
+  const stmt = db.query(sql);
+  return stmt.all(...params);
+}
+function getObservationsByIds(db, ids) {
+  if (!Array.isArray(ids) || ids.length === 0) return [];
+  const validIds = ids.filter((id) => typeof id === "number" && Number.isInteger(id) && id > 0).slice(0, 500);
+  if (validIds.length === 0) return [];
+  const placeholders = validIds.map(() => "?").join(",");
+  const sql = `SELECT * FROM observations WHERE id IN (${placeholders}) ORDER BY created_at_epoch DESC`;
+  const stmt = db.query(sql);
+  return stmt.all(...validIds);
+}
+function getTimeline(db, anchorId, depthBefore = 5, depthAfter = 5) {
+  const anchorStmt = db.query("SELECT created_at_epoch FROM observations WHERE id = ?");
+  const anchor = anchorStmt.get(anchorId);
+  if (!anchor) return [];
+  const anchorEpoch = anchor.created_at_epoch;
+  const beforeStmt = db.query(`
+    SELECT id, 'observation' as type, title, text as content, project, created_at, created_at_epoch
+    FROM observations
+    WHERE created_at_epoch < ?
+    ORDER BY created_at_epoch DESC
+    LIMIT ?
+  `);
+  const before = beforeStmt.all(anchorEpoch, depthBefore).reverse();
+  const selfStmt = db.query(`
+    SELECT id, 'observation' as type, title, text as content, project, created_at, created_at_epoch
+    FROM observations WHERE id = ?
+  `);
+  const self = selfStmt.all(anchorId);
+  const afterStmt = db.query(`
+    SELECT id, 'observation' as type, title, text as content, project, created_at, created_at_epoch
+    FROM observations
+    WHERE created_at_epoch > ?
+    ORDER BY created_at_epoch ASC
+    LIMIT ?
+  `);
+  const after = afterStmt.all(anchorEpoch, depthAfter);
+  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 = ?");
+  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
+  };
+}
+function getStaleObservations(db, project) {
+  const rows = db.query(`
+    SELECT * FROM observations
+    WHERE project = ? AND files_modified IS NOT NULL AND files_modified != ''
+    ORDER BY created_at_epoch DESC
+    LIMIT 500
+  `).all(project);
+  const staleObs = [];
+  for (const obs of rows) {
+    if (!obs.files_modified) continue;
+    const files = obs.files_modified.split(",").map((f) => f.trim()).filter(Boolean);
+    let isStale = false;
+    for (const filepath of files) {
+      try {
+        if (!existsSync4(filepath)) continue;
+        const stat = statSync(filepath);
+        if (stat.mtimeMs > obs.created_at_epoch) {
+          isStale = true;
+          break;
+        }
+      } catch {
+      }
+    }
+    if (isStale) {
+      staleObs.push(obs);
+    }
+  }
+  return staleObs;
+}
+function markObservationsStale(db, ids, stale) {
+  if (!Array.isArray(ids) || ids.length === 0) return;
+  const validIds = ids.filter((id) => typeof id === "number" && Number.isInteger(id) && id > 0).slice(0, 500);
+  if (validIds.length === 0) return;
+  const placeholders = validIds.map(() => "?").join(",");
+  db.run(
+    `UPDATE observations SET is_stale = ? WHERE id IN (${placeholders})`,
+    [stale ? 1 : 0, ...validIds]
+  );
+}
+var init_Search = __esm({
+  "src/services/sqlite/Search.ts"() {
+    "use strict";
+  }
+});
 
 // src/hooks/utils.ts
 import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
 import { join } from "path";
+
+// src/services/search/ScoringEngine.ts
+var SEARCH_WEIGHTS = {
+  semantic: 0.4,
+  fts5: 0.3,
+  recency: 0.2,
+  projectMatch: 0.1
+};
+var CONTEXT_WEIGHTS = {
+  semantic: 0,
+  fts5: 0,
+  recency: 0.7,
+  projectMatch: 0.3
+};
+function recencyScore(createdAtEpoch, halfLifeHours = 168) {
+  if (!createdAtEpoch || createdAtEpoch <= 0) return 0;
+  const nowMs = Date.now();
+  const ageMs = nowMs - createdAtEpoch;
+  if (ageMs <= 0) return 1;
+  const ageHours = ageMs / (1e3 * 60 * 60);
+  return Math.exp(-ageHours * Math.LN2 / halfLifeHours);
+}
+function normalizeFTS5Rank(rank, allRanks) {
+  if (allRanks.length === 0) return 0;
+  if (allRanks.length === 1) return 1;
+  const minRank = Math.min(...allRanks);
+  const maxRank = Math.max(...allRanks);
+  if (minRank === maxRank) return 1;
+  return (maxRank - rank) / (maxRank - minRank);
+}
+function projectMatchScore(itemProject, targetProject) {
+  if (!itemProject || !targetProject) return 0;
+  return itemProject.toLowerCase() === targetProject.toLowerCase() ? 1 : 0;
+}
+function computeCompositeScore(signals, weights) {
+  return signals.semantic * weights.semantic + signals.fts5 * weights.fts5 + signals.recency * weights.recency + signals.projectMatch * weights.projectMatch;
+}
+var KNOWLEDGE_TYPE_BOOST = {
+  constraint: 1.3,
+  decision: 1.25,
+  heuristic: 1.15,
+  rejected: 1.1
+};
+function knowledgeTypeBoost(type) {
+  return KNOWLEDGE_TYPE_BOOST[type] ?? 1;
+}
+function estimateTokens(text) {
+  if (!text) return 0;
+  return Math.ceil(text.length / 4);
+}
+
+// src/hooks/utils.ts
 var DATA_DIR = process.env.KIRO_MEMORY_DATA_DIR || process.env.CONTEXTKIT_DATA_DIR || join(process.env.HOME || "/tmp", ".kiro-memory");
 var TOKEN_FILE = join(DATA_DIR, "worker.token");
 function debugLog(hookName, label, data) {
@@ -30,10 +448,19 @@ async function readStdin() {
   return new Promise((resolve, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
+    const safetyTimeout = setTimeout(() => {
+      if (!data.trim()) {
+        resolve({
+          hook_event_name: "agentSpawn",
+          cwd: process.cwd()
+        });
+      }
+    }, 5e3);
     process.stdin.on("data", (chunk) => {
       data += chunk;
     });
     process.stdin.on("end", () => {
+      clearTimeout(safetyTimeout);
       try {
         if (!data.trim()) {
           resolve({
@@ -47,15 +474,10 @@ async function readStdin() {
         reject(new Error(`Errore parsing stdin JSON: ${err}`));
       }
     });
-    process.stdin.on("error", reject);
-    setTimeout(() => {
-      if (!data.trim()) {
-        resolve({
-          hook_event_name: "agentSpawn",
-          cwd: process.cwd()
-        });
-      }
-    }, 5e3);
+    process.stdin.on("error", (err) => {
+      clearTimeout(safetyTimeout);
+      reject(err);
+    });
   });
 }
 function detectProject(cwd) {
@@ -71,34 +493,61 @@ function detectProject(cwd) {
     return cwd.split("/").pop() || "default";
   }
 }
-function formatContext(data) {
+function formatSmartContext(data) {
+  const budget = data.tokenBudget || parseInt(process.env.KIRO_MEMORY_CONTEXT_TOKENS || "0", 10) || 2e3;
   let output = "";
+  let tokensUsed = 0;
+  const header = "# Kiro Memory: Contesto Sessioni Precedenti\n\n";
+  tokensUsed += estimateTokens(header);
+  output += header;
   if (data.summaries && data.summaries.length > 0) {
-    output += "## Sessioni Precedenti\n\n";
-    data.summaries.slice(0, 3).forEach((sum) => {
-      if (sum.learned) output += `- **Appreso**: ${sum.learned}
+    let sumSection = "## Sessioni Precedenti\n\n";
+    for (const sum of data.summaries.slice(0, 3)) {
+      if (sum.learned) sumSection += `- **Appreso**: ${sum.learned}
 `;
-      if (sum.completed) output += `- **Completato**: ${sum.completed}
+      if (sum.completed) sumSection += `- **Completato**: ${sum.completed}
 `;
-      if (sum.next_steps) output += `- **Prossimi passi**: ${sum.next_steps}
+      if (sum.next_steps) sumSection += `- **Prossimi passi**: ${sum.next_steps}
 `;
-      output += "\n";
-    });
-  }
-  if (data.observations && data.observations.length > 0) {
-    output += "## Osservazioni Recenti\n\n";
-    data.observations.slice(0, 10).forEach((obs) => {
-      const text = obs.text ? obs.text.substring(0, 150) : "";
-      output += `- **[${obs.type || "obs"}] ${obs.title}**: ${text}
+      sumSection += "\n";
+    }
+    tokensUsed += estimateTokens(sumSection);
+    output += sumSection;
+  }
+  if (data.items && data.items.length > 0) {
+    let obsSection = "## Osservazioni Rilevanti\n\n";
+    tokensUsed += estimateTokens(obsSection);
+    const sorted = [...data.items].sort((a, b) => b.score - a.score);
+    for (const item of sorted) {
+      const linePrefix = `- **[${item.type}] ${item.title}**: `;
+      const linePrefixTokens = estimateTokens(linePrefix);
+      const remainingTokens = budget - tokensUsed - linePrefixTokens - 1;
+      if (remainingTokens <= 0) break;
+      const maxContentChars = remainingTokens * 4;
+      const content = item.content ? item.content.substring(0, Math.min(maxContentChars, 300)) : "";
+      const line = `${linePrefix}${content}
 `;
-    });
-    output += "\n";
+      tokensUsed += estimateTokens(line);
+      obsSection += line;
+      if (tokensUsed >= budget) break;
+    }
+    output += obsSection;
   }
+  const footer = `
+> Progetto: ${data.project} | Items: ${data.items?.length || 0} | Token usati: ~${tokensUsed}/${budget}
+`;
+  output += footer;
   return output;
 }
 async function runHook(name, handler) {
   try {
     const input = await readStdin();
+    if (!input.cwd && input.workspace_roots?.[0]) {
+      input.cwd = input.workspace_roots[0];
+    }
+    if (!input.session_id && input.conversation_id) {
+      input.session_id = input.conversation_id;
+    }
     debugLog(name, "stdin", input);
     await handler(input);
     debugLog(name, "completato", { success: true });
@@ -638,12 +1087,61 @@ var MigrationRunner = class {
           `);
           db.run("CREATE UNIQUE INDEX IF NOT EXISTS idx_project_aliases_name ON project_aliases(project_name)");
         }
-      }
-    ];
-  }
-};
-
-// src/services/sqlite/Sessions.ts
+      },
+      {
+        version: 4,
+        up: (db) => {
+          db.run(`
+            CREATE TABLE IF NOT EXISTS observation_embeddings (
+              observation_id INTEGER PRIMARY KEY,
+              embedding BLOB NOT NULL,
+              model TEXT NOT NULL,
+              dimensions INTEGER NOT NULL,
+              created_at TEXT NOT NULL,
+              FOREIGN KEY (observation_id) REFERENCES observations(id) ON DELETE CASCADE
+            )
+          `);
+          db.run("CREATE INDEX IF NOT EXISTS idx_embeddings_model ON observation_embeddings(model)");
+        }
+      },
+      {
+        version: 5,
+        up: (db) => {
+          db.run("ALTER TABLE observations ADD COLUMN last_accessed_epoch INTEGER");
+          db.run("ALTER TABLE observations ADD COLUMN is_stale INTEGER DEFAULT 0");
+          db.run("CREATE INDEX IF NOT EXISTS idx_observations_last_accessed ON observations(last_accessed_epoch)");
+          db.run("CREATE INDEX IF NOT EXISTS idx_observations_stale ON observations(is_stale)");
+        }
+      },
+      {
+        version: 6,
+        up: (db) => {
+          db.run(`
+            CREATE TABLE IF NOT EXISTS checkpoints (
+              id INTEGER PRIMARY KEY AUTOINCREMENT,
+              session_id INTEGER NOT NULL,
+              project TEXT NOT NULL,
+              task TEXT NOT NULL,
+              progress TEXT,
+              next_steps TEXT,
+              open_questions TEXT,
+              relevant_files TEXT,
+              context_snapshot TEXT,
+              created_at TEXT NOT NULL,
+              created_at_epoch INTEGER NOT NULL,
+              FOREIGN KEY (session_id) REFERENCES sessions(id)
+            )
+          `);
+          db.run("CREATE INDEX IF NOT EXISTS idx_checkpoints_session ON checkpoints(session_id)");
+          db.run("CREATE INDEX IF NOT EXISTS idx_checkpoints_project ON checkpoints(project)");
+          db.run("CREATE INDEX IF NOT EXISTS idx_checkpoints_epoch ON checkpoints(created_at_epoch)");
+        }
+      }
+    ];
+  }
+};
+
+// src/services/sqlite/Sessions.ts
 function createSession(db, contentSessionId, project, userPrompt) {
   const now = /* @__PURE__ */ new Date();
   const result = db.run(
@@ -667,38 +1165,13 @@ function completeSession(db, id) {
   );
 }
 
-// src/services/sqlite/Observations.ts
-function createObservation(db, memorySessionId, project, type, title, subtitle, text, narrative, facts, concepts, filesRead, filesModified, promptNumber) {
-  const now = /* @__PURE__ */ new Date();
-  const result = db.run(
-    `INSERT INTO observations 
-     (memory_session_id, project, type, title, subtitle, text, narrative, facts, concepts, files_read, files_modified, prompt_number, created_at, created_at_epoch)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    [memorySessionId, project, type, title, subtitle, text, narrative, facts, concepts, filesRead, filesModified, promptNumber, now.toISOString(), now.getTime()]
-  );
-  return Number(result.lastInsertRowid);
-}
-function getObservationsByProject(db, project, limit = 100) {
-  const query = db.query(
-    "SELECT * FROM observations WHERE project = ? ORDER BY created_at_epoch DESC LIMIT ?"
-  );
-  return query.all(project, limit);
-}
-function searchObservations(db, searchTerm, project) {
-  const sql = project ? `SELECT * FROM observations 
-       WHERE project = ? AND (title LIKE ? OR text LIKE ? OR narrative LIKE ?)
-       ORDER BY created_at_epoch DESC` : `SELECT * FROM observations 
-       WHERE title LIKE ? OR text LIKE ? OR narrative LIKE ?
-       ORDER BY created_at_epoch DESC`;
-  const pattern = `%${searchTerm}%`;
-  const query = db.query(sql);
-  if (project) {
-    return query.all(project, pattern, pattern, pattern);
-  }
-  return query.all(pattern, pattern, pattern);
-}
+// src/services/sqlite/index.ts
+init_Observations();
 
 // src/services/sqlite/Summaries.ts
+function escapeLikePattern2(input) {
+  return input.replace(/[%_\\]/g, "\\$&");
+}
 function createSummary(db, sessionId, project, request, investigated, learned, completed, nextSteps, notes) {
   const now = /* @__PURE__ */ new Date();
   const result = db.run(
@@ -716,12 +1189,12 @@ function getSummariesByProject(db, project, limit = 50) {
   return query.all(project, limit);
 }
 function searchSummaries(db, searchTerm, project) {
-  const sql = project ? `SELECT * FROM summaries 
-       WHERE project = ? AND (request LIKE ? OR learned LIKE ? OR completed LIKE ? OR notes LIKE ?)
-       ORDER BY created_at_epoch DESC` : `SELECT * FROM summaries 
-       WHERE request LIKE ? OR learned LIKE ? OR completed LIKE ? OR notes LIKE ?
+  const sql = project ? `SELECT * FROM summaries
+       WHERE project = ? AND (request LIKE ? ESCAPE '\\' OR learned LIKE ? ESCAPE '\\' OR completed LIKE ? ESCAPE '\\' OR notes LIKE ? ESCAPE '\\')
+       ORDER BY created_at_epoch DESC` : `SELECT * FROM summaries
+       WHERE request LIKE ? ESCAPE '\\' OR learned LIKE ? ESCAPE '\\' OR completed LIKE ? ESCAPE '\\' OR notes LIKE ? ESCAPE '\\'
        ORDER BY created_at_epoch DESC`;
-  const pattern = `%${searchTerm}%`;
+  const pattern = `%${escapeLikePattern2(searchTerm)}%`;
   const query = db.query(sql);
   if (project) {
     return query.all(project, pattern, pattern, pattern, pattern);
@@ -747,136 +1220,596 @@ function getPromptsByProject(db, project, limit = 100) {
   return query.all(project, limit);
 }
 
-// src/services/sqlite/Search.ts
-function sanitizeFTS5Query(query) {
-  const terms = query.replace(/[""]/g, "").split(/\s+/).filter((t) => t.length > 0).map((t) => `"${t}"`);
-  return terms.join(" ");
+// src/services/sqlite/Checkpoints.ts
+function createCheckpoint(db, sessionId, project, data) {
+  const now = /* @__PURE__ */ new Date();
+  const result = db.run(
+    `INSERT INTO checkpoints (session_id, project, task, progress, next_steps, open_questions, relevant_files, context_snapshot, created_at, created_at_epoch)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+    [
+      sessionId,
+      project,
+      data.task,
+      data.progress || null,
+      data.nextSteps || null,
+      data.openQuestions || null,
+      data.relevantFiles || null,
+      data.contextSnapshot || null,
+      now.toISOString(),
+      now.getTime()
+    ]
+  );
+  return Number(result.lastInsertRowid);
 }
-function searchObservationsFTS(db, query, filters = {}) {
-  const limit = filters.limit || 50;
-  try {
-    const safeQuery = sanitizeFTS5Query(query);
-    if (!safeQuery) return searchObservationsLIKE(db, query, filters);
-    let sql = `
-      SELECT o.* FROM observations o
-      JOIN observations_fts fts ON o.id = fts.rowid
-      WHERE observations_fts MATCH ?
-    `;
-    const params = [safeQuery];
-    if (filters.project) {
-      sql += " AND o.project = ?";
-      params.push(filters.project);
+function getLatestCheckpoint(db, sessionId) {
+  const query = db.query(
+    "SELECT * FROM checkpoints WHERE session_id = ? ORDER BY created_at_epoch DESC LIMIT 1"
+  );
+  return query.get(sessionId);
+}
+function getLatestCheckpointByProject(db, project) {
+  const query = db.query(
+    "SELECT * FROM checkpoints WHERE project = ? ORDER BY created_at_epoch DESC LIMIT 1"
+  );
+  return query.get(project);
+}
+
+// src/services/sqlite/Reports.ts
+function getReportData(db, project, startEpoch, endEpoch) {
+  const startDate = new Date(startEpoch);
+  const endDate = new Date(endEpoch);
+  const days = Math.ceil((endEpoch - startEpoch) / (24 * 60 * 60 * 1e3));
+  const label = days <= 7 ? "Weekly" : days <= 31 ? "Monthly" : "Custom";
+  const countInRange = (table, epochCol = "created_at_epoch") => {
+    const sql = project ? `SELECT COUNT(*) as count FROM ${table} WHERE project = ? AND ${epochCol} >= ? AND ${epochCol} <= ?` : `SELECT COUNT(*) as count FROM ${table} WHERE ${epochCol} >= ? AND ${epochCol} <= ?`;
+    const stmt = db.query(sql);
+    const row = project ? stmt.get(project, startEpoch, endEpoch) : stmt.get(startEpoch, endEpoch);
+    return row?.count || 0;
+  };
+  const observations = countInRange("observations");
+  const summaries = countInRange("summaries");
+  const prompts = countInRange("prompts");
+  const sessions = countInRange("sessions", "started_at_epoch");
+  const timelineSql = project ? `SELECT DATE(datetime(created_at_epoch / 1000, 'unixepoch')) as day, COUNT(*) as count
+       FROM observations
+       WHERE project = ? AND created_at_epoch >= ? AND created_at_epoch <= ?
+       GROUP BY day ORDER BY day ASC` : `SELECT DATE(datetime(created_at_epoch / 1000, 'unixepoch')) as day, COUNT(*) as count
+       FROM observations
+       WHERE created_at_epoch >= ? AND created_at_epoch <= ?
+       GROUP BY day ORDER BY day ASC`;
+  const timelineStmt = db.query(timelineSql);
+  const timeline = project ? timelineStmt.all(project, startEpoch, endEpoch) : timelineStmt.all(startEpoch, endEpoch);
+  const typeSql = project ? `SELECT type, COUNT(*) as count FROM observations
+       WHERE project = ? AND created_at_epoch >= ? AND created_at_epoch <= ?
+       GROUP BY type ORDER BY count DESC` : `SELECT type, COUNT(*) as count FROM observations
+       WHERE created_at_epoch >= ? AND created_at_epoch <= ?
+       GROUP BY type ORDER BY count DESC`;
+  const typeStmt = db.query(typeSql);
+  const typeDistribution = project ? typeStmt.all(project, startEpoch, endEpoch) : typeStmt.all(startEpoch, endEpoch);
+  const sessionTotalSql = project ? `SELECT COUNT(*) as count FROM sessions WHERE project = ? AND started_at_epoch >= ? AND started_at_epoch <= ?` : `SELECT COUNT(*) as count FROM sessions WHERE started_at_epoch >= ? AND started_at_epoch <= ?`;
+  const sessionTotal = (project ? db.query(sessionTotalSql).get(project, startEpoch, endEpoch)?.count : db.query(sessionTotalSql).get(startEpoch, endEpoch)?.count) || 0;
+  const sessionCompletedSql = project ? `SELECT COUNT(*) as count FROM sessions WHERE project = ? AND started_at_epoch >= ? AND started_at_epoch <= ? AND status = 'completed'` : `SELECT COUNT(*) as count FROM sessions WHERE started_at_epoch >= ? AND started_at_epoch <= ? AND status = 'completed'`;
+  const sessionCompleted = (project ? db.query(sessionCompletedSql).get(project, startEpoch, endEpoch)?.count : db.query(sessionCompletedSql).get(startEpoch, endEpoch)?.count) || 0;
+  const sessionAvgSql = project ? `SELECT AVG((completed_at_epoch - started_at_epoch) / 1000.0 / 60.0) as avg_min
+       FROM sessions
+       WHERE project = ? AND started_at_epoch >= ? AND started_at_epoch <= ?
+         AND status = 'completed' AND completed_at_epoch IS NOT NULL AND completed_at_epoch > started_at_epoch` : `SELECT AVG((completed_at_epoch - started_at_epoch) / 1000.0 / 60.0) as avg_min
+       FROM sessions
+       WHERE started_at_epoch >= ? AND started_at_epoch <= ?
+         AND status = 'completed' AND completed_at_epoch IS NOT NULL AND completed_at_epoch > started_at_epoch`;
+  const avgRow = project ? db.query(sessionAvgSql).get(project, startEpoch, endEpoch) : db.query(sessionAvgSql).get(startEpoch, endEpoch);
+  const avgDurationMinutes = Math.round((avgRow?.avg_min || 0) * 10) / 10;
+  const knowledgeSql = project ? `SELECT COUNT(*) as count FROM observations
+       WHERE project = ? AND created_at_epoch >= ? AND created_at_epoch <= ?
+         AND type IN ('constraint', 'decision', 'heuristic', 'rejected')` : `SELECT COUNT(*) as count FROM observations
+       WHERE created_at_epoch >= ? AND created_at_epoch <= ?
+         AND type IN ('constraint', 'decision', 'heuristic', 'rejected')`;
+  const knowledgeCount = (project ? db.query(knowledgeSql).get(project, startEpoch, endEpoch)?.count : db.query(knowledgeSql).get(startEpoch, endEpoch)?.count) || 0;
+  const staleSql = project ? `SELECT COUNT(*) as count FROM observations
+       WHERE project = ? AND created_at_epoch >= ? AND created_at_epoch <= ? AND is_stale = 1` : `SELECT COUNT(*) as count FROM observations
+       WHERE created_at_epoch >= ? AND created_at_epoch <= ? AND is_stale = 1`;
+  const staleCount = (project ? db.query(staleSql).get(project, startEpoch, endEpoch)?.count : db.query(staleSql).get(startEpoch, endEpoch)?.count) || 0;
+  const summarySql = project ? `SELECT learned, completed, next_steps FROM summaries
+       WHERE project = ? AND created_at_epoch >= ? AND created_at_epoch <= ?
+       ORDER BY created_at_epoch DESC` : `SELECT learned, completed, next_steps FROM summaries
+       WHERE created_at_epoch >= ? AND created_at_epoch <= ?
+       ORDER BY created_at_epoch DESC`;
+  const summaryRows = project ? db.query(summarySql).all(project, startEpoch, endEpoch) : db.query(summarySql).all(startEpoch, endEpoch);
+  const topLearnings = [];
+  const completedTasks = [];
+  const nextStepsArr = [];
+  for (const row of summaryRows) {
+    if (row.learned) {
+      const parts = row.learned.split("; ").filter(Boolean);
+      topLearnings.push(...parts);
     }
-    if (filters.type) {
-      sql += " AND o.type = ?";
-      params.push(filters.type);
+    if (row.completed) {
+      const parts = row.completed.split("; ").filter(Boolean);
+      completedTasks.push(...parts);
     }
-    if (filters.dateStart) {
-      sql += " AND o.created_at_epoch >= ?";
-      params.push(filters.dateStart);
+    if (row.next_steps) {
+      const parts = row.next_steps.split("; ").filter(Boolean);
+      nextStepsArr.push(...parts);
     }
-    if (filters.dateEnd) {
-      sql += " AND o.created_at_epoch <= ?";
-      params.push(filters.dateEnd);
+  }
+  const filesSql = project ? `SELECT files_modified FROM observations
+       WHERE project = ? AND created_at_epoch >= ? AND created_at_epoch <= ?
+         AND files_modified IS NOT NULL AND files_modified != ''` : `SELECT files_modified FROM observations
+       WHERE created_at_epoch >= ? AND created_at_epoch <= ?
+         AND files_modified IS NOT NULL AND files_modified != ''`;
+  const fileRows = project ? db.query(filesSql).all(project, startEpoch, endEpoch) : db.query(filesSql).all(startEpoch, endEpoch);
+  const fileCounts = /* @__PURE__ */ new Map();
+  for (const row of fileRows) {
+    const files = row.files_modified.split(",").map((f) => f.trim()).filter(Boolean);
+    for (const file of files) {
+      fileCounts.set(file, (fileCounts.get(file) || 0) + 1);
     }
-    sql += " ORDER BY rank LIMIT ?";
-    params.push(limit);
-    const stmt = db.query(sql);
-    return stmt.all(...params);
-  } catch {
-    return searchObservationsLIKE(db, query, filters);
   }
+  const fileHotspots = Array.from(fileCounts.entries()).map(([file, count]) => ({ file, count })).sort((a, b) => b.count - a.count).slice(0, 15);
+  return {
+    period: {
+      start: startDate.toISOString().split("T")[0],
+      end: endDate.toISOString().split("T")[0],
+      days,
+      label
+    },
+    overview: {
+      observations,
+      summaries,
+      sessions,
+      prompts,
+      knowledgeCount,
+      staleCount
+    },
+    timeline,
+    typeDistribution,
+    sessionStats: {
+      total: sessionTotal,
+      completed: sessionCompleted,
+      avgDurationMinutes
+    },
+    topLearnings: [...new Set(topLearnings)].slice(0, 10),
+    completedTasks: [...new Set(completedTasks)].slice(0, 10),
+    nextSteps: [...new Set(nextStepsArr)].slice(0, 10),
+    fileHotspots
+  };
 }
-function searchObservationsLIKE(db, query, filters = {}) {
-  const limit = filters.limit || 50;
-  const pattern = `%${query}%`;
-  let sql = `
-    SELECT * FROM observations
-    WHERE (title LIKE ? OR text LIKE ? OR narrative LIKE ? OR concepts LIKE ?)
-  `;
-  const params = [pattern, pattern, pattern, pattern];
-  if (filters.project) {
-    sql += " AND project = ?";
-    params.push(filters.project);
+
+// src/services/sqlite/index.ts
+init_Search();
+
+// src/sdk/index.ts
+init_Observations();
+init_Search();
+
+// src/services/search/EmbeddingService.ts
+var EmbeddingService = class {
+  provider = null;
+  model = null;
+  initialized = false;
+  initializing = null;
+  /**
+   * Inizializza il servizio di embedding.
+   * Tenta fastembed, poi @huggingface/transformers, poi fallback a null.
+   */
+  async initialize() {
+    if (this.initialized) return this.provider !== null;
+    if (this.initializing) return this.initializing;
+    this.initializing = this._doInitialize();
+    const result = await this.initializing;
+    this.initializing = null;
+    return result;
   }
-  if (filters.type) {
-    sql += " AND type = ?";
-    params.push(filters.type);
+  async _doInitialize() {
+    try {
+      const fastembed = await import("fastembed");
+      const EmbeddingModel = fastembed.EmbeddingModel || fastembed.default?.EmbeddingModel;
+      const FlagEmbedding = fastembed.FlagEmbedding || fastembed.default?.FlagEmbedding;
+      if (FlagEmbedding && EmbeddingModel) {
+        this.model = await FlagEmbedding.init({
+          model: EmbeddingModel.BGESmallENV15
+        });
+        this.provider = "fastembed";
+        this.initialized = true;
+        logger.info("EMBEDDING", "Inizializzato con fastembed (BGE-small-en-v1.5)");
+        return true;
+      }
+    } catch (error) {
+      logger.debug("EMBEDDING", `fastembed non disponibile: ${error}`);
+    }
+    try {
+      const transformers = await import("@huggingface/transformers");
+      const pipeline = transformers.pipeline || transformers.default?.pipeline;
+      if (pipeline) {
+        this.model = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2", {
+          quantized: true
+        });
+        this.provider = "transformers";
+        this.initialized = true;
+        logger.info("EMBEDDING", "Inizializzato con @huggingface/transformers (all-MiniLM-L6-v2)");
+        return true;
+      }
+    } catch (error) {
+      logger.debug("EMBEDDING", `@huggingface/transformers non disponibile: ${error}`);
+    }
+    this.provider = null;
+    this.initialized = true;
+    logger.warn("EMBEDDING", "Nessun provider embedding disponibile, ricerca semantica disabilitata");
+    return false;
   }
-  if (filters.dateStart) {
-    sql += " AND created_at_epoch >= ?";
-    params.push(filters.dateStart);
+  /**
+   * Genera embedding per un singolo testo.
+   * Ritorna Float32Array con 384 dimensioni, o null se non disponibile.
+   */
+  async embed(text) {
+    if (!this.initialized) await this.initialize();
+    if (!this.provider || !this.model) return null;
+    try {
+      const truncated = text.substring(0, 2e3);
+      if (this.provider === "fastembed") {
+        return await this._embedFastembed(truncated);
+      } else if (this.provider === "transformers") {
+        return await this._embedTransformers(truncated);
+      }
+    } catch (error) {
+      logger.error("EMBEDDING", `Errore generazione embedding: ${error}`);
+    }
+    return null;
   }
-  if (filters.dateEnd) {
-    sql += " AND created_at_epoch <= ?";
-    params.push(filters.dateEnd);
+  /**
+   * Genera embeddings in batch.
+   */
+  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);
+      }
+    }
+    return results;
   }
-  sql += " ORDER BY created_at_epoch DESC LIMIT ?";
-  params.push(limit);
-  const stmt = db.query(sql);
-  return stmt.all(...params);
-}
-function searchSummariesFiltered(db, query, filters = {}) {
-  const limit = filters.limit || 20;
-  const pattern = `%${query}%`;
-  let sql = `
-    SELECT * FROM summaries
-    WHERE (request LIKE ? OR learned LIKE ? OR completed LIKE ? OR notes LIKE ? OR next_steps LIKE ?)
-  `;
-  const params = [pattern, pattern, pattern, pattern, pattern];
-  if (filters.project) {
-    sql += " AND project = ?";
-    params.push(filters.project);
+  /**
+   * Verifica se il servizio è disponibile.
+   */
+  isAvailable() {
+    return this.initialized && this.provider !== null;
   }
-  if (filters.dateStart) {
-    sql += " AND created_at_epoch >= ?";
-    params.push(filters.dateStart);
+  /**
+   * Nome del provider attivo.
+   */
+  getProvider() {
+    return this.provider;
   }
-  if (filters.dateEnd) {
-    sql += " AND created_at_epoch <= ?";
-    params.push(filters.dateEnd);
+  /**
+   * Dimensioni del vettore embedding.
+   */
+  getDimensions() {
+    return 384;
+  }
+  // --- Provider specifici ---
+  async _embedFastembed(text) {
+    const embeddings = this.model.embed([text], 1);
+    for await (const batch of embeddings) {
+      if (batch && batch.length > 0) {
+        const vec = batch[0];
+        return vec instanceof Float32Array ? vec : new Float32Array(vec);
+      }
+    }
+    return null;
   }
-  sql += " ORDER BY created_at_epoch DESC LIMIT ?";
-  params.push(limit);
-  const stmt = db.query(sql);
-  return stmt.all(...params);
+  async _embedTransformers(text) {
+    const output = await this.model(text, {
+      pooling: "mean",
+      normalize: true
+    });
+    if (output?.data) {
+      return output.data instanceof Float32Array ? output.data : new Float32Array(output.data);
+    }
+    return null;
+  }
+};
+var embeddingService = null;
+function getEmbeddingService() {
+  if (!embeddingService) {
+    embeddingService = new EmbeddingService();
+  }
+  return embeddingService;
 }
-function getObservationsByIds(db, ids) {
-  if (ids.length === 0) return [];
-  const placeholders = ids.map(() => "?").join(",");
-  const sql = `SELECT * FROM observations WHERE id IN (${placeholders}) ORDER BY created_at_epoch DESC`;
-  const stmt = db.query(sql);
-  return stmt.all(...ids);
+
+// src/services/search/VectorSearch.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== 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);
+  if (denominator === 0) return 0;
+  return dotProduct / denominator;
 }
-function getTimeline(db, anchorId, depthBefore = 5, depthAfter = 5) {
-  const anchorStmt = db.query("SELECT created_at_epoch FROM observations WHERE id = ?");
-  const anchor = anchorStmt.get(anchorId);
-  if (!anchor) return [];
-  const anchorEpoch = anchor.created_at_epoch;
-  const beforeStmt = db.query(`
-    SELECT id, 'observation' as type, title, text as content, project, created_at, created_at_epoch
-    FROM observations
-    WHERE created_at_epoch < ?
-    ORDER BY created_at_epoch DESC
-    LIMIT ?
-  `);
-  const before = beforeStmt.all(anchorEpoch, depthBefore).reverse();
-  const selfStmt = db.query(`
-    SELECT id, 'observation' as type, title, text as content, project, created_at, created_at_epoch
-    FROM observations WHERE id = ?
-  `);
-  const self = selfStmt.all(anchorId);
-  const afterStmt = db.query(`
-    SELECT id, 'observation' as type, title, text as content, project, created_at, created_at_epoch
-    FROM observations
-    WHERE created_at_epoch > ?
-    ORDER BY created_at_epoch ASC
-    LIMIT ?
-  `);
-  const after = afterStmt.all(anchorEpoch, depthAfter);
-  return [...before, ...self, ...after];
+function float32ToBuffer(arr) {
+  return Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength);
+}
+function bufferToFloat32(buf) {
+  const arrayBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+  return new Float32Array(arrayBuffer);
+}
+var VectorSearch = class {
+  /**
+   * Ricerca semantica: calcola cosine similarity tra query e tutti gli embeddings.
+   */
+  async search(db, queryEmbedding, options = {}) {
+    const limit = options.limit || 10;
+    const threshold = options.threshold || 0.3;
+    try {
+      let 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
+      `;
+      const params = [];
+      if (options.project) {
+        sql += " WHERE o.project = ?";
+        params.push(options.project);
+      }
+      const rows = db.query(sql).all(...params);
+      const scored = [];
+      for (const row of rows) {
+        const embedding = bufferToFloat32(row.embedding);
+        const similarity = cosineSimilarity(queryEmbedding, embedding);
+        if (similarity >= threshold) {
+          scored.push({
+            id: row.observation_id,
+            observationId: row.observation_id,
+            similarity,
+            title: row.title,
+            text: row.text,
+            type: row.type,
+            project: row.project,
+            created_at: row.created_at,
+            created_at_epoch: row.created_at_epoch
+          });
+        }
+      }
+      scored.sort((a, b) => b.similarity - a.similarity);
+      return scored.slice(0, limit);
+    } catch (error) {
+      logger.error("VECTOR", `Errore ricerca vettoriale: ${error}`);
+      return [];
+    }
+  }
+  /**
+   * Salva embedding per un'osservazione.
+   */
+  async storeEmbedding(db, observationId, embedding, model) {
+    try {
+      const blob = float32ToBuffer(embedding);
+      db.query(`
+        INSERT OR REPLACE INTO observation_embeddings
+          (observation_id, embedding, model, dimensions, created_at)
+        VALUES (?, ?, ?, ?, ?)
+      `).run(
+        observationId,
+        blob,
+        model,
+        embedding.length,
+        (/* @__PURE__ */ new Date()).toISOString()
+      );
+      logger.debug("VECTOR", `Embedding salvato per osservazione ${observationId}`);
+    } catch (error) {
+      logger.error("VECTOR", `Errore salvataggio embedding: ${error}`);
+    }
+  }
+  /**
+   * Genera embeddings per osservazioni che non li hanno ancora.
+   */
+  async backfillEmbeddings(db, batchSize = 50) {
+    const embeddingService2 = getEmbeddingService();
+    if (!await embeddingService2.initialize()) {
+      logger.warn("VECTOR", "Embedding service non disponibile, backfill saltato");
+      return 0;
+    }
+    const rows = db.query(`
+      SELECT o.id, o.title, o.text, o.narrative, o.concepts
+      FROM observations o
+      LEFT JOIN observation_embeddings e ON e.observation_id = o.id
+      WHERE e.observation_id IS NULL
+      ORDER BY o.created_at_epoch DESC
+      LIMIT ?
+    `).all(batchSize);
+    if (rows.length === 0) return 0;
+    let count = 0;
+    const model = embeddingService2.getProvider() || "unknown";
+    for (const row of rows) {
+      const parts = [row.title];
+      if (row.text) parts.push(row.text);
+      if (row.narrative) parts.push(row.narrative);
+      if (row.concepts) parts.push(row.concepts);
+      const fullText = parts.join(" ").substring(0, 2e3);
+      const embedding = await embeddingService2.embed(fullText);
+      if (embedding) {
+        await this.storeEmbedding(db, row.id, embedding, model);
+        count++;
+      }
+    }
+    logger.info("VECTOR", `Backfill completato: ${count}/${rows.length} embeddings generati`);
+    return count;
+  }
+  /**
+   * Statistiche sugli embeddings.
+   */
+  getStats(db) {
+    try {
+      const totalRow = db.query("SELECT COUNT(*) as count FROM observations").get();
+      const embeddedRow = db.query("SELECT COUNT(*) as count FROM observation_embeddings").get();
+      const total = totalRow?.count || 0;
+      const embedded = embeddedRow?.count || 0;
+      const percentage = total > 0 ? Math.round(embedded / total * 100) : 0;
+      return { total, embedded, percentage };
+    } catch {
+      return { total: 0, embedded: 0, percentage: 0 };
+    }
+  }
+};
+var vectorSearch = null;
+function getVectorSearch() {
+  if (!vectorSearch) {
+    vectorSearch = new VectorSearch();
+  }
+  return vectorSearch;
 }
 
+// src/services/search/HybridSearch.ts
+var HybridSearch = class {
+  embeddingInitialized = false;
+  /**
+   * Inizializza il servizio di embedding (lazy, non bloccante)
+   */
+  async initialize() {
+    try {
+      const embeddingService2 = getEmbeddingService();
+      await embeddingService2.initialize();
+      this.embeddingInitialized = embeddingService2.isAvailable();
+      logger.info("SEARCH", `HybridSearch inizializzato (embedding: ${this.embeddingInitialized ? "attivo" : "disattivato"})`);
+    } catch (error) {
+      logger.warn("SEARCH", "Inizializzazione embedding fallita, uso solo FTS5", {}, error);
+      this.embeddingInitialized = false;
+    }
+  }
+  /**
+   * Ricerca ibrida con scoring a 4 segnali
+   */
+  async search(db, query, options = {}) {
+    const limit = options.limit || 10;
+    const weights = options.weights || SEARCH_WEIGHTS;
+    const targetProject = options.project || "";
+    const rawItems = /* @__PURE__ */ new Map();
+    if (this.embeddingInitialized) {
+      try {
+        const embeddingService2 = getEmbeddingService();
+        const queryEmbedding = await embeddingService2.embed(query);
+        if (queryEmbedding) {
+          const vectorSearch2 = getVectorSearch();
+          const vectorResults = await vectorSearch2.search(db, queryEmbedding, {
+            project: options.project,
+            limit: limit * 2,
+            // Prendiamo piu risultati per il ranking
+            threshold: 0.3
+          });
+          for (const hit of vectorResults) {
+            rawItems.set(String(hit.observationId), {
+              id: String(hit.observationId),
+              title: hit.title,
+              content: hit.text || "",
+              type: hit.type,
+              project: hit.project,
+              created_at: hit.created_at,
+              created_at_epoch: hit.created_at_epoch,
+              semanticScore: hit.similarity,
+              fts5Rank: null,
+              source: "vector"
+            });
+          }
+          logger.debug("SEARCH", `Vector search: ${vectorResults.length} risultati`);
+        }
+      } catch (error) {
+        logger.warn("SEARCH", "Ricerca vettoriale fallita, uso solo keyword", {}, error);
+      }
+    }
+    try {
+      const { searchObservationsFTSWithRank: searchObservationsFTSWithRank2 } = await Promise.resolve().then(() => (init_Search(), Search_exports));
+      const keywordResults = searchObservationsFTSWithRank2(db, query, {
+        project: options.project,
+        limit: limit * 2
+      });
+      for (const obs of keywordResults) {
+        const id = String(obs.id);
+        const existing = rawItems.get(id);
+        if (existing) {
+          existing.fts5Rank = obs.fts5_rank;
+          existing.source = "vector";
+        } else {
+          rawItems.set(id, {
+            id,
+            title: obs.title,
+            content: obs.text || obs.narrative || "",
+            type: obs.type,
+            project: obs.project,
+            created_at: obs.created_at,
+            created_at_epoch: obs.created_at_epoch,
+            semanticScore: 0,
+            fts5Rank: obs.fts5_rank,
+            source: "keyword"
+          });
+        }
+      }
+      logger.debug("SEARCH", `Keyword search: ${keywordResults.length} risultati`);
+    } catch (error) {
+      logger.error("SEARCH", "Ricerca keyword fallita", {}, error);
+    }
+    if (rawItems.size === 0) return [];
+    const allFTS5Ranks = Array.from(rawItems.values()).filter((item) => item.fts5Rank !== null).map((item) => item.fts5Rank);
+    const scored = [];
+    for (const item of rawItems.values()) {
+      const signals = {
+        semantic: item.semanticScore,
+        fts5: item.fts5Rank !== null ? normalizeFTS5Rank(item.fts5Rank, allFTS5Ranks) : 0,
+        recency: recencyScore(item.created_at_epoch),
+        projectMatch: targetProject ? projectMatchScore(item.project, targetProject) : 0
+      };
+      const score = computeCompositeScore(signals, weights);
+      const isHybrid = item.semanticScore > 0 && item.fts5Rank !== null;
+      const hybridBoost = isHybrid ? 1.15 : 1;
+      const finalScore = Math.min(1, score * hybridBoost * knowledgeTypeBoost(item.type));
+      scored.push({
+        id: item.id,
+        title: item.title,
+        content: item.content,
+        type: item.type,
+        project: item.project,
+        created_at: item.created_at,
+        created_at_epoch: item.created_at_epoch,
+        score: finalScore,
+        source: isHybrid ? "hybrid" : item.source,
+        signals
+      });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    const finalResults = scored.slice(0, limit);
+    if (finalResults.length > 0) {
+      try {
+        const { updateLastAccessed: updateLastAccessed3 } = await Promise.resolve().then(() => (init_Observations(), Observations_exports));
+        const ids = finalResults.map((r) => parseInt(r.id, 10)).filter((id) => id > 0);
+        if (ids.length > 0) {
+          updateLastAccessed3(db, ids);
+        }
+      } catch {
+      }
+    }
+    return finalResults;
+  }
+};
+var hybridSearch = null;
+function getHybridSearch() {
+  if (!hybridSearch) {
+    hybridSearch = new HybridSearch();
+  }
+  return hybridSearch;
+}
+
+// src/types/worker-types.ts
+var KNOWLEDGE_TYPES = ["constraint", "decision", "heuristic", "rejected"];
+
 // src/sdk/index.ts
 var KiroMemorySDK = class {
   db;
@@ -909,11 +1842,62 @@ var KiroMemorySDK = class {
       recentPrompts: getPromptsByProject(this.db.db, this.project, 10)
     };
   }
+  /**
+   * Valida input per storeObservation
+   */
+  validateObservationInput(data) {
+    if (!data.type || typeof data.type !== "string" || data.type.length > 100) {
+      throw new Error("type \xE8 obbligatorio (stringa, max 100 caratteri)");
+    }
+    if (!data.title || typeof data.title !== "string" || data.title.length > 500) {
+      throw new Error("title \xE8 obbligatorio (stringa, max 500 caratteri)");
+    }
+    if (!data.content || typeof data.content !== "string" || data.content.length > 1e5) {
+      throw new Error("content \xE8 obbligatorio (stringa, max 100KB)");
+    }
+  }
+  /**
+   * Valida input per 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)`);
+      }
+    }
+  }
+  /**
+   * Genera e salva embedding per un'osservazione (fire-and-forget, non blocca)
+   */
+  async generateEmbeddingAsync(observationId, title, content, concepts) {
+    try {
+      const embeddingService2 = getEmbeddingService();
+      if (!embeddingService2.isAvailable()) return;
+      const parts = [title, content];
+      if (concepts?.length) parts.push(concepts.join(", "));
+      const fullText = parts.join(" ").substring(0, 2e3);
+      const embedding = await embeddingService2.embed(fullText);
+      if (embedding) {
+        const vectorSearch2 = getVectorSearch();
+        await vectorSearch2.storeEmbedding(
+          this.db.db,
+          observationId,
+          embedding,
+          embeddingService2.getProvider() || "unknown"
+        );
+      }
+    } catch (error) {
+      logger.debug("SDK", `Embedding generation fallita per obs ${observationId}: ${error}`);
+    }
+  }
   /**
    * Store a new observation
    */
   async storeObservation(data) {
-    return createObservation(
+    this.validateObservationInput(data);
+    const observationId = createObservation(
       this.db.db,
       "sdk-" + Date.now(),
       this.project,
@@ -934,11 +1918,76 @@ var KiroMemorySDK = class {
       0
       // prompt_number
     );
+    this.generateEmbeddingAsync(observationId, data.title, data.content, data.concepts).catch(() => {
+    });
+    return observationId;
+  }
+  /**
+   * Salva conoscenza strutturata (constraint, decision, heuristic, rejected).
+   * Usa il campo `type` per il knowledgeType e `facts` per i metadati JSON.
+   */
+  async storeKnowledge(data) {
+    if (!KNOWLEDGE_TYPES.includes(data.knowledgeType)) {
+      throw new Error(`knowledgeType non valido: ${data.knowledgeType}. Valori ammessi: ${KNOWLEDGE_TYPES.join(", ")}`);
+    }
+    this.validateObservationInput({ type: data.knowledgeType, title: data.title, content: data.content });
+    const metadata = (() => {
+      switch (data.knowledgeType) {
+        case "constraint":
+          return {
+            knowledgeType: "constraint",
+            severity: data.metadata?.severity || "soft",
+            reason: data.metadata?.reason
+          };
+        case "decision":
+          return {
+            knowledgeType: "decision",
+            alternatives: data.metadata?.alternatives,
+            reason: data.metadata?.reason
+          };
+        case "heuristic":
+          return {
+            knowledgeType: "heuristic",
+            context: data.metadata?.context,
+            confidence: data.metadata?.confidence
+          };
+        case "rejected":
+          return {
+            knowledgeType: "rejected",
+            reason: data.metadata?.reason || "",
+            alternatives: data.metadata?.alternatives
+          };
+      }
+    })();
+    const observationId = createObservation(
+      this.db.db,
+      "sdk-" + Date.now(),
+      data.project || this.project,
+      data.knowledgeType,
+      // type = knowledgeType
+      data.title,
+      null,
+      // subtitle
+      data.content,
+      null,
+      // narrative
+      JSON.stringify(metadata),
+      // facts = metadati JSON
+      data.concepts?.join(", ") || null,
+      data.files?.join(", ") || null,
+      data.files?.join(", ") || null,
+      0
+      // prompt_number
+    );
+    this.generateEmbeddingAsync(observationId, data.title, data.content, data.concepts).catch(() => {
+    });
+    return observationId;
   }
   /**
    * Store a session summary
    */
   async storeSummary(data) {
+    this.validateSummaryInput(data);
     return createSummary(
       this.db.db,
       "sdk-" + Date.now(),
@@ -1034,6 +2083,227 @@ var KiroMemorySDK = class {
   getProject() {
     return this.project;
   }
+  /**
+   * Ricerca ibrida: vector search + keyword FTS5
+   * Richiede inizializzazione HybridSearch (embedding service)
+   */
+  async hybridSearch(query, options = {}) {
+    const hybridSearch2 = getHybridSearch();
+    return hybridSearch2.search(this.db.db, query, {
+      project: this.project,
+      limit: options.limit || 10
+    });
+  }
+  /**
+   * Ricerca solo semantica (vector search)
+   * Ritorna risultati basati su similarità coseno con gli embeddings
+   */
+  async semanticSearch(query, options = {}) {
+    const embeddingService2 = getEmbeddingService();
+    if (!embeddingService2.isAvailable()) {
+      await embeddingService2.initialize();
+    }
+    if (!embeddingService2.isAvailable()) return [];
+    const queryEmbedding = await embeddingService2.embed(query);
+    if (!queryEmbedding) return [];
+    const vectorSearch2 = getVectorSearch();
+    const results = await vectorSearch2.search(this.db.db, queryEmbedding, {
+      project: this.project,
+      limit: options.limit || 10,
+      threshold: options.threshold || 0.3
+    });
+    return results.map((r) => ({
+      id: String(r.observationId),
+      title: r.title,
+      content: r.text || "",
+      type: r.type,
+      project: r.project,
+      created_at: r.created_at,
+      created_at_epoch: r.created_at_epoch,
+      score: r.similarity,
+      source: "vector",
+      signals: {
+        semantic: r.similarity,
+        fts5: 0,
+        recency: recencyScore(r.created_at_epoch),
+        projectMatch: projectMatchScore(r.project, this.project)
+      }
+    }));
+  }
+  /**
+   * Genera embeddings per osservazioni che non li hanno ancora
+   */
+  async backfillEmbeddings(batchSize = 50) {
+    const vectorSearch2 = getVectorSearch();
+    return vectorSearch2.backfillEmbeddings(this.db.db, batchSize);
+  }
+  /**
+   * Statistiche sugli embeddings nel database
+   */
+  getEmbeddingStats() {
+    const vectorSearch2 = getVectorSearch();
+    return vectorSearch2.getStats(this.db.db);
+  }
+  /**
+   * Inizializza il servizio di embedding (lazy, chiamare prima di hybridSearch)
+   */
+  async initializeEmbeddings() {
+    const hybridSearch2 = getHybridSearch();
+    await hybridSearch2.initialize();
+    return getEmbeddingService().isAvailable();
+  }
+  /**
+   * Contesto smart con ranking a 4 segnali e budget token.
+   *
+   * Se query presente: usa HybridSearch con SEARCH_WEIGHTS.
+   * Se senza query: ranking per recency + project match (CONTEXT_WEIGHTS).
+   */
+  async getSmartContext(options = {}) {
+    const tokenBudget = options.tokenBudget || parseInt(process.env.KIRO_MEMORY_CONTEXT_TOKENS || "0", 10) || 2e3;
+    const summaries = getSummariesByProject(this.db.db, this.project, 5);
+    let items;
+    if (options.query) {
+      const hybridSearch2 = getHybridSearch();
+      const results = await hybridSearch2.search(this.db.db, options.query, {
+        project: this.project,
+        limit: 30
+      });
+      items = results.map((r) => ({
+        id: parseInt(r.id, 10) || 0,
+        title: r.title,
+        content: r.content,
+        type: r.type,
+        project: r.project,
+        created_at: r.created_at,
+        created_at_epoch: r.created_at_epoch,
+        score: r.score,
+        signals: r.signals
+      }));
+    } else {
+      const observations = getObservationsByProject(this.db.db, this.project, 30);
+      items = observations.map((obs) => {
+        const signals = {
+          semantic: 0,
+          fts5: 0,
+          recency: recencyScore(obs.created_at_epoch),
+          projectMatch: projectMatchScore(obs.project, this.project)
+        };
+        const baseScore = computeCompositeScore(signals, CONTEXT_WEIGHTS);
+        const boostedScore = Math.min(1, baseScore * knowledgeTypeBoost(obs.type));
+        return {
+          id: obs.id,
+          title: obs.title,
+          content: obs.text || obs.narrative || "",
+          type: obs.type,
+          project: obs.project,
+          created_at: obs.created_at,
+          created_at_epoch: obs.created_at_epoch,
+          score: boostedScore,
+          signals
+        };
+      });
+      items.sort((a, b) => b.score - a.score);
+    }
+    let tokensUsed = 0;
+    for (const item of items) {
+      tokensUsed += Math.ceil((item.title.length + item.content.length) / 4);
+      if (tokensUsed > tokenBudget) break;
+    }
+    return {
+      project: this.project,
+      items,
+      summaries,
+      tokenBudget,
+      tokensUsed: Math.min(tokensUsed, tokenBudget)
+    };
+  }
+  /**
+   * Rileva osservazioni stale (file modificati dopo la creazione) e le marca nel DB.
+   * Ritorna il numero di osservazioni marcate come stale.
+   */
+  async detectStaleObservations() {
+    const staleObs = getStaleObservations(this.db.db, this.project);
+    if (staleObs.length > 0) {
+      const ids = staleObs.map((o) => o.id);
+      markObservationsStale(this.db.db, ids, true);
+    }
+    return staleObs.length;
+  }
+  /**
+   * Consolida osservazioni duplicate sullo stesso file e tipo.
+   * Raggruppa per (project, type, files_modified), mantiene la piu recente.
+   */
+  async consolidateObservations(options = {}) {
+    return consolidateObservations(this.db.db, this.project, options);
+  }
+  /**
+   * Statistiche decay: totale, stale, mai accedute, accedute di recente.
+   */
+  async getDecayStats() {
+    const total = this.db.db.query(
+      "SELECT COUNT(*) as count FROM observations WHERE project = ?"
+    ).get(this.project)?.count || 0;
+    const stale = this.db.db.query(
+      "SELECT COUNT(*) as count FROM observations WHERE project = ? AND is_stale = 1"
+    ).get(this.project)?.count || 0;
+    const neverAccessed = this.db.db.query(
+      "SELECT COUNT(*) as count FROM observations WHERE project = ? AND last_accessed_epoch IS NULL"
+    ).get(this.project)?.count || 0;
+    const recentThreshold = Date.now() - 48 * 60 * 60 * 1e3;
+    const recentlyAccessed = this.db.db.query(
+      "SELECT COUNT(*) as count FROM observations WHERE project = ? AND last_accessed_epoch > ?"
+    ).get(this.project, recentThreshold)?.count || 0;
+    return { total, stale, neverAccessed, recentlyAccessed };
+  }
+  /**
+   * Crea un checkpoint strutturato per resume sessione.
+   * Salva automaticamente un context_snapshot con le ultime 10 osservazioni.
+   */
+  async createCheckpoint(sessionId, data) {
+    const recentObs = getObservationsByProject(this.db.db, this.project, 10);
+    const contextSnapshot = JSON.stringify(
+      recentObs.map((o) => ({ id: o.id, type: o.type, title: o.title, text: o.text?.substring(0, 200) }))
+    );
+    return createCheckpoint(this.db.db, sessionId, this.project, {
+      task: data.task,
+      progress: data.progress,
+      nextSteps: data.nextSteps,
+      openQuestions: data.openQuestions,
+      relevantFiles: data.relevantFiles?.join(", "),
+      contextSnapshot
+    });
+  }
+  /**
+   * Recupera l'ultimo checkpoint di una sessione specifica.
+   */
+  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.
+   */
+  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.
+   */
+  async generateReport(options) {
+    const now = /* @__PURE__ */ new Date();
+    let startEpoch;
+    let endEpoch = now.getTime();
+    if (options?.startDate && options?.endDate) {
+      startEpoch = options.startDate.getTime();
+      endEpoch = options.endDate.getTime();
+    } else {
+      const period = options?.period || "weekly";
+      const daysBack = period === "monthly" ? 30 : 7;
+      startEpoch = endEpoch - daysBack * 24 * 60 * 60 * 1e3;
+    }
+    return getReportData(this.db.db, this.project, startEpoch, endEpoch);
+  }
   /**
    * Getter for direct database access (for API routes)
    */
@@ -1094,19 +2364,15 @@ runHook("agentSpawn", async (input) => {
   const project = detectProject(input.cwd);
   const sdk = createKiroMemory({ project });
   try {
-    const ctx = await sdk.getContext();
-    if (ctx.relevantObservations.length === 0 && ctx.relevantSummaries.length === 0) {
+    const smartCtx = await sdk.getSmartContext();
+    if (smartCtx.items.length === 0 && smartCtx.summaries.length === 0) {
       return;
     }
-    let output = "# Kiro Memory: Contesto Sessioni Precedenti\n\n";
-    output += formatContext({
-      observations: ctx.relevantObservations,
-      summaries: ctx.relevantSummaries,
-      prompts: ctx.recentPrompts
+    let output = formatSmartContext({
+      items: smartCtx.items,
+      summaries: smartCtx.summaries,
+      project
     });
-    output += `
-> Progetto: ${project} | Osservazioni: ${ctx.relevantObservations.length} | Sommari: ${ctx.relevantSummaries.length}
-`;
     output += `> UI disponibile su http://127.0.0.1:${process.env.KIRO_MEMORY_WORKER_PORT || "3001"}
 `;
     process.stdout.write(output);