fix: FTS5 dots, semantic search, vector embeddings

- FTS5: wrap queries in quotes to handle dots/special chars
- vec_raw_observations: enable by default (skip_vector=False)
- Project: pass project from sessions to vector embeddings
- source=semantic tag for vector search results in CLI
- docs: sync version to 2.0.22

Author: barrelc

docs/index.html

@@ -51,7 +51,7 @@ <h1>🧠 kimi-mneme</h1>
         <p class="subtitle">Persistent Memory Plugin for Kimi Code CLI</p>
 
         <div>
-            <span class="badge badge-pypi">PyPI v<!-- VERSION -->2.0.17<!-- /VERSION --></span>
+            <span class="badge badge-pypi">PyPI v<!-- VERSION -->2.0.22<!-- /VERSION --></span>
             <span class="badge badge-python">Python 3.10+</span>
             <span class="badge badge-license">AGPL-3.0</span>
             <span class="badge badge-kimi">Kimi CLI Plugin</span>

mneme/db/store.py

@@ -110,7 +110,7 @@ def end_session(self, session_id: str, reason: str) -> None:
     # Observations
     # -----------------------------------------------------------------------
 
-    def add_observation(self, observation: Observation, skip_vector: bool = True) -> int:
+    def add_observation(self, observation: Observation, skip_vector: bool = False) -> int:
         """Add an observation and return its ID."""
         content = self._observation_to_text(observation)
         content_hash = self._hash_content(content) if content else None
@@ -168,12 +168,25 @@ def add_observation(self, observation: Observation, skip_vector: bool = True) ->
         if obs_id and not skip_vector:
             # Add to sqlite-vec for semantic search
             if content:
+                # Get project from session
+                project = ""
+                try:
+                    with self._get_conn() as conn:
+                        row = conn.execute(
+                            "SELECT project FROM sessions WHERE id = ?",
+                            (observation.session_id,),
+                        ).fetchone()
+                        if row:
+                            project = row["project"] or ""
+                except Exception:
+                    pass
                 self.sqlite_vec.add_raw_observation(
                     observation_id=obs_id,
                     session_id=observation.session_id,
                     content=content,
                     event_type=observation.event_type,
                     tool_name=observation.tool_name or "",
+                    project=project,
                 )
             logger.debug(f"Observation added: {obs_id}")
         else:
@@ -222,12 +235,15 @@ def search(
     ) -> list[dict[str, Any]]:
         """Hybrid search: FTS + fallback LIKE + vector similarity."""
         # Build FTS query with OR between words for better recall
+        # Sanitize query for FTS5: wrap in quotes to handle special chars like dots
+        # FTS5 treats unquoted dots as column filters (column_name.token), which fails
+        # Quoted strings are treated as literal phrases
         words = [w for w in query.strip().split() if len(w) > 2]
         if words:
-            # Try exact phrase first, then individual words with OR
-            fts_query = f'"{query}" OR ' + " OR ".join(words) if len(words) > 1 else query
+            # Try exact phrase first (quoted), then individual words with OR
+            fts_query = f'"{query}" OR ' + " OR ".join(words) if len(words) > 1 else f'"{query}"'
         else:
-            fts_query = query
+            fts_query = f'"{query}"'
 
         fts_results: list[dict[str, Any]] = []
 
@@ -341,7 +357,8 @@ def search(
                         "tool_name": vr.get("tool_name"),
                         "file_path": None,
                         "created_at": None,
-                        "snippet": "",
+                        "snippet": f"[semantic match, distance={vr.get('distance', 0):.3f}]",
+                        "source": "semantic",
                         "vector_distance": vr.get("distance"),
                     }
                 )

mneme/db/structured_store.py

@@ -267,10 +267,11 @@ def get_for_injection(
     def search_fts(self, query: str, limit: int = 10) -> list[dict[str, Any]]:
         """Full-text search over structured observations."""
         words = [w for w in query.strip().split() if len(w) > 2]
+        # Sanitize query for FTS5: wrap in quotes to handle special chars like dots
         if words:
-            fts_query = f'"{query}" OR ' + " OR ".join(words) if len(words) > 1 else query
+            fts_query = f'"{query}" OR ' + " OR ".join(words) if len(words) > 1 else f'"{query}"'
         else:
-            fts_query = query
+            fts_query = f'"{query}"'
 
         with self._get_conn() as conn:
             try:

mneme/db/wire_store.py

@@ -352,7 +352,7 @@ def add_observation_from_wire(
             prompt=prompt,
             created_at=created_at,
         )
-        obs_id = store.add_observation(obs, skip_vector=True)
+        obs_id = store.add_observation(obs, skip_vector=False)
 
         # Queue for background structuring
         if obs_id: