feat(searcher): include stored metadata on search hits

Hits from search_memories() carried only display fields (text, wing, room,
similarity, distances); every field a consumer stamped at ingest was dropped
in flattening. Downstream filters and re-rankers (session-aware recall,
provenance rules, custom pipelines) need those fields to match on.

Each hit now carries its stored metadata dict whole. Covered by a seeded
round-trip test; internal underscore-prefixed fields still strip as before.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: joshuafontany

mempalace/searcher.py

@@ -1315,6 +1315,11 @@ def search_memories(
             "effective_distance": round(effective_dist, 4),
             "closet_boost": round(boost, 3),
             "matched_via": matched_via,
+            # The drawer's stored metadata rides through whole: consumers that
+            # filter or re-rank hits (session-aware recall, provenance rules,
+            # custom pipelines) need the fields they stamped at ingest — a hit
+            # flattened to display fields blinds every downstream filter.
+            "metadata": dict(meta or {}),
             # Internal: retain the full source_file path + chunk_index so the
             # enrichment step below doesn't have to reverse-lookup via
             # basename-suffix matching (which silently collides when two

tests/conftest.py

@@ -227,6 +227,7 @@ def seeded_collection(collection):
                 "chunk_index": 0,
                 "added_by": "miner",
                 "filed_at": "2026-01-01T00:00:00",
+                "origin_handle": "session-alpha",
             },
             {
                 "wing": "project",

tests/test_searcher.py

@@ -73,6 +73,19 @@ def test_basic_search(self, palace_path, seeded_collection):
         assert len(result["results"]) > 0
         assert result["query"] == "JWT authentication"
 
+    def test_hits_carry_their_stored_metadata(self, palace_path, seeded_collection):
+        """Consumers that filter or re-rank hits need the fields they stamped at
+        ingest; a hit flattened to display fields blinds every downstream filter."""
+        result = search_memories("JWT authentication", palace_path)
+        hit = result["results"][0]
+        assert "metadata" in hit
+        assert hit["metadata"].get("origin_handle") == "session-alpha"
+        assert hit["metadata"].get("wing") == "project"
+        # a drawer without custom stamps still carries its stored metadata whole
+        other = search_memories("React frontend", palace_path)["results"][0]
+        assert "origin_handle" not in other["metadata"]
+        assert other["metadata"].get("room") == "frontend"
+
     def test_wing_filter(self, palace_path, seeded_collection):
         result = search_memories("planning", palace_path, wing="notes")
         assert all(r["wing"] == "notes" for r in result["results"])