@prmichaelsen/remember-mcp 3.15.5 → 3.15.7

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.15.7] - 2026-03-07
+
+### Changed
+
+- Expand tool descriptions for `remember_search_by`, `remember_search_ghost_memory_by`, and `remember_search_space_by` with full mode explanations and complete property reference for byProperty mode
+- Add inline mode descriptions to `mode` enum field so agents see them in schema-only views
+- Document all sortable properties: 21 emotions, 10 functional signals, 3 composite scores, core fields, ratings, and REM metadata
+
 ## [3.15.5] - 2026-03-07
 
 ### Changed

package/dist/server-factory.js

@@ -2866,7 +2866,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -2915,7 +2915,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -2958,7 +2958,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3006,7 +3006,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3049,7 +3049,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3151,7 +3151,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3213,7 +3213,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3259,7 +3259,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3321,7 +3321,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3424,7 +3424,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -8177,14 +8177,25 @@ var searchByTool = {
   Use remember_find_similar for vector similarity.
   Use this tool for structured browsing, sorting, and discovery.
 
+  byBroad returns truncated content (content_head/mid/tail ~100 chars each) instead of full content.
+  Use it to scan large collections, then drill into specific memories with other search tools.
+
+  Available sort_field values for byProperty:
+  Emotions (0-1): feel_emotional_significance, feel_vulnerability, feel_trauma, feel_humor, feel_happiness, feel_sadness, feel_fear, feel_anger, feel_surprise, feel_disgust, feel_contempt, feel_embarrassment, feel_shame, feel_guilt, feel_excitement, feel_pride, feel_intensity, feel_coherence_tension
+  Affect dimensions: feel_valence (-1 to 1), feel_arousal (0-1), feel_dominance (0-1)
+  Functional signals (0-1): functional_salience, functional_urgency, functional_social_weight, functional_agency, functional_novelty, functional_retrieval_utility, functional_narrative_importance, functional_aesthetic_quality, functional_valence, functional_coherence_tension
+  Composite scores: feel_significance, functional_significance, total_significance
+  Core: weight, trust_score, confidence, strength, relationship_count, version, access_count
+  Ratings: rating_sum, rating_count, rating_bayesian
+  REM metadata: rem_visits (times scored by REM)
+
   byProperty examples:
   - { mode: "byProperty", sort_field: "feel_trauma", sort_order: "desc" } \u2014 most traumatic
   - { mode: "byProperty", sort_field: "feel_humor", sort_order: "desc" } \u2014 funniest
-  - { mode: "byProperty", sort_field: "feel_retrieval_utility", sort_order: "desc" } \u2014 most useful
+  - { mode: "byProperty", sort_field: "functional_retrieval_utility", sort_order: "desc" } \u2014 most useful
   - { mode: "byProperty", sort_field: "rem_visits", sort_order: "asc" } \u2014 least scored by REM
-
-  byBroad returns truncated content (content_head/mid/tail ~100 chars each) instead of full content.
-  Use it to scan large collections, then drill into specific memories with other search tools.`,
+  - { mode: "byProperty", sort_field: "total_significance", sort_order: "desc" } \u2014 most significant overall
+  - { mode: "byProperty", sort_field: "functional_novelty", sort_order: "desc" } \u2014 most novel`,
   inputSchema: {
     type: "object",
     properties: {
@@ -8612,15 +8623,35 @@ async function handleQueryGhostMemory(args, userId, authContext) {
 // src/tools/search-ghost-memory-by.ts
 var searchGhostMemoryByTool = {
   name: "remember_search_ghost_memory_by",
-  description: `Search ghost memories using specialized modes (byTime, byDensity,
-  byProperty, byBroad, etc.). Automatically filters to content_type: ghost.`,
+  description: `Search ghost memories using specialized sort/discovery modes. Automatically filters to content_type: ghost.
+
+  Modes:
+  - byTime: Chronological sort (newest/oldest first)
+  - byDensity: Sort by relationship count (most connected ghost memories)
+  - byRating: Sort by Bayesian rating average (social ratings from spaces)
+  - byDiscovery: Interleaved rated + unrated content for exploration (4:1 ratio)
+  - byProperty: Sort by any memory property (e.g., feel_trauma, weight, feel_salience). Requires sort_field.
+  - bySignificance: Sort by total_significance (combined emotional + functional score from REM)
+  - byBroad: Massive results with truncated content (content_head/mid/tail ~100 chars each) for scan-and-drill-in workflow
+  - byRandom: Random sampling for serendipitous rediscovery
+
+  Use remember_search_ghost_memory for hybrid semantic+keyword search.
+  Use this tool for structured browsing, sorting, and discovery of ghost interaction records.
+
+  Available sort_field values for byProperty:
+  Emotions (0-1): feel_emotional_significance, feel_vulnerability, feel_trauma, feel_humor, feel_happiness, feel_sadness, feel_fear, feel_anger, feel_surprise, feel_disgust, feel_contempt, feel_embarrassment, feel_shame, feel_guilt, feel_excitement, feel_pride, feel_intensity, feel_coherence_tension
+  Affect dimensions: feel_valence (-1 to 1), feel_arousal (0-1), feel_dominance (0-1)
+  Functional signals (0-1): functional_salience, functional_urgency, functional_social_weight, functional_agency, functional_novelty, functional_retrieval_utility, functional_narrative_importance, functional_aesthetic_quality, functional_valence, functional_coherence_tension
+  Composite scores: feel_significance, functional_significance, total_significance
+  Core: weight, trust_score, relationship_count, version
+  REM metadata: rem_visits`,
   inputSchema: {
     type: "object",
     properties: {
       mode: {
         type: "string",
         enum: ["byTime", "byDensity", "byRating", "byDiscovery", "byProperty", "bySignificance", "byRandom", "byBroad"],
-        description: "Search mode"
+        description: "Search mode: byTime (chronological), byDensity (most connected), byRating (highest rated), byDiscovery (explore mix), byProperty (sort by field), bySignificance (emotional+functional score), byRandom (random sample), byBroad (scan many truncated)"
       },
       query: { type: "string", description: "Optional search query" },
       sort_order: { type: "string", enum: ["asc", "desc"] },
@@ -8746,25 +8777,36 @@ async function handleGetCore(args, userId, _authContext) {
 // src/tools/search-space-by.ts
 var searchSpaceByTool = {
   name: "remember_search_space_by",
-  description: `Search shared spaces using specialized modes. Similar to remember_search_by
-  but operates on published memories in spaces and groups.
+  description: `Search published memories in shared spaces/groups using specialized sort/discovery modes.
 
   Modes:
-  - byTime: Chronological sort of published memories
-  - byRating: Sort by Bayesian rating average (social ratings)
-  - byDiscovery: Interleaved rated + unrated for exploration
-  - byProperty: Sort by any property (e.g., feel_trauma, total_significance)
-  - byBroad: Massive results with truncated content
-  - byRandom: Random sampling from space
-
-  At least one of 'spaces' or 'groups' must be provided.`,
+  - byTime: Chronological sort (newest/oldest first)
+  - byRating: Sort by Bayesian rating average (social ratings from other users)
+  - byDiscovery: Interleaved rated + unrated content for exploration (4:1 ratio). Good for finding hidden gems.
+  - byProperty: Sort by any memory property (e.g., feel_trauma, total_significance, weight). Requires sort_field.
+  - byBroad: Massive results with truncated content (content_head/mid/tail ~100 chars each) for scan-and-drill-in workflow
+  - byRandom: Random sampling for serendipitous discovery
+
+  At least one of 'spaces' or 'groups' must be provided.
+
+  Use remember_search_space for hybrid semantic+keyword search of space memories.
+  Use this tool for structured browsing, sorting, and discovery of published content.
+
+  Available sort_field values for byProperty:
+  Emotions (0-1): feel_emotional_significance, feel_vulnerability, feel_trauma, feel_humor, feel_happiness, feel_sadness, feel_fear, feel_anger, feel_surprise, feel_disgust, feel_contempt, feel_embarrassment, feel_shame, feel_guilt, feel_excitement, feel_pride, feel_intensity, feel_coherence_tension
+  Affect dimensions: feel_valence (-1 to 1), feel_arousal (0-1), feel_dominance (0-1)
+  Functional signals (0-1): functional_salience, functional_urgency, functional_social_weight, functional_agency, functional_novelty, functional_retrieval_utility, functional_narrative_importance, functional_aesthetic_quality, functional_valence, functional_coherence_tension
+  Composite scores: feel_significance, functional_significance, total_significance
+  Core: weight, trust_score, relationship_count, version
+  Ratings: rating_sum, rating_count, rating_bayesian
+  Published: discovery_count, revision_count`,
   inputSchema: {
     type: "object",
     properties: {
       mode: {
         type: "string",
         enum: ["byTime", "byRating", "byDiscovery", "byProperty", "byBroad", "byRandom"],
-        description: "Search mode"
+        description: "Search mode: byTime (chronological), byRating (highest rated), byDiscovery (explore mix), byProperty (sort by field), byBroad (scan many truncated), byRandom (random sample)"
       },
       spaces: {
         type: "array",

package/dist/server.js

@@ -2870,7 +2870,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -2919,7 +2919,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -2962,7 +2962,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3010,7 +3010,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3053,7 +3053,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3155,7 +3155,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3217,7 +3217,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3263,7 +3263,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3325,7 +3325,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {
@@ -3428,7 +3428,7 @@ var MemoryService = class {
     if (input.ghost_context) {
       ghostFilters.push(buildTrustFilter(this.collection, input.ghost_context.accessor_trust_level));
     }
-    if (!input.ghost_context?.include_ghost_content) {
+    if (!input.ghost_context?.include_ghost_content && !input.filters?.types?.includes("ghost")) {
       ghostFilters.push(this.collection.filter.byProperty("content_type").notEqual("ghost"));
     }
     if (!input.filters?.types?.includes("rem")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/remember-mcp",
-  "version": "3.15.5",
+  "version": "3.15.7",
   "description": "Multi-tenant memory system MCP server with vector search and relationships",
   "main": "dist/server.js",
   "type": "module",
@@ -52,7 +52,7 @@
     "@modelcontextprotocol/sdk": "^1.0.4",
     "@prmichaelsen/firebase-admin-sdk-v8": "^2.2.0",
     "@prmichaelsen/mcp-auth": "^7.0.4",
-    "@prmichaelsen/remember-core": "^0.44.1",
+    "@prmichaelsen/remember-core": "^0.45.0",
     "dotenv": "^16.4.5",
     "uuid": "^13.0.0",
     "weaviate-client": "^3.2.0"

package/src/tools/search-by.ts

@@ -34,14 +34,25 @@ export const searchByTool = {
   Use remember_find_similar for vector similarity.
   Use this tool for structured browsing, sorting, and discovery.
 
+  byBroad returns truncated content (content_head/mid/tail ~100 chars each) instead of full content.
+  Use it to scan large collections, then drill into specific memories with other search tools.
+
+  Available sort_field values for byProperty:
+  Emotions (0-1): feel_emotional_significance, feel_vulnerability, feel_trauma, feel_humor, feel_happiness, feel_sadness, feel_fear, feel_anger, feel_surprise, feel_disgust, feel_contempt, feel_embarrassment, feel_shame, feel_guilt, feel_excitement, feel_pride, feel_intensity, feel_coherence_tension
+  Affect dimensions: feel_valence (-1 to 1), feel_arousal (0-1), feel_dominance (0-1)
+  Functional signals (0-1): functional_salience, functional_urgency, functional_social_weight, functional_agency, functional_novelty, functional_retrieval_utility, functional_narrative_importance, functional_aesthetic_quality, functional_valence, functional_coherence_tension
+  Composite scores: feel_significance, functional_significance, total_significance
+  Core: weight, trust_score, confidence, strength, relationship_count, version, access_count
+  Ratings: rating_sum, rating_count, rating_bayesian
+  REM metadata: rem_visits (times scored by REM)
+
   byProperty examples:
   - { mode: "byProperty", sort_field: "feel_trauma", sort_order: "desc" } — most traumatic
   - { mode: "byProperty", sort_field: "feel_humor", sort_order: "desc" } — funniest
-  - { mode: "byProperty", sort_field: "feel_retrieval_utility", sort_order: "desc" } — most useful
+  - { mode: "byProperty", sort_field: "functional_retrieval_utility", sort_order: "desc" } — most useful
   - { mode: "byProperty", sort_field: "rem_visits", sort_order: "asc" } — least scored by REM
-
-  byBroad returns truncated content (content_head/mid/tail ~100 chars each) instead of full content.
-  Use it to scan large collections, then drill into specific memories with other search tools.`,
+  - { mode: "byProperty", sort_field: "total_significance", sort_order: "desc" } — most significant overall
+  - { mode: "byProperty", sort_field: "functional_novelty", sort_order: "desc" } — most novel`,
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/search-ghost-memory-by.ts

@@ -11,15 +11,35 @@ import type { SearchByMode } from './search-by.js';
 
 export const searchGhostMemoryByTool = {
   name: 'remember_search_ghost_memory_by',
-  description: `Search ghost memories using specialized modes (byTime, byDensity,
-  byProperty, byBroad, etc.). Automatically filters to content_type: ghost.`,
+  description: `Search ghost memories using specialized sort/discovery modes. Automatically filters to content_type: ghost.
+
+  Modes:
+  - byTime: Chronological sort (newest/oldest first)
+  - byDensity: Sort by relationship count (most connected ghost memories)
+  - byRating: Sort by Bayesian rating average (social ratings from spaces)
+  - byDiscovery: Interleaved rated + unrated content for exploration (4:1 ratio)
+  - byProperty: Sort by any memory property (e.g., feel_trauma, weight, feel_salience). Requires sort_field.
+  - bySignificance: Sort by total_significance (combined emotional + functional score from REM)
+  - byBroad: Massive results with truncated content (content_head/mid/tail ~100 chars each) for scan-and-drill-in workflow
+  - byRandom: Random sampling for serendipitous rediscovery
+
+  Use remember_search_ghost_memory for hybrid semantic+keyword search.
+  Use this tool for structured browsing, sorting, and discovery of ghost interaction records.
+
+  Available sort_field values for byProperty:
+  Emotions (0-1): feel_emotional_significance, feel_vulnerability, feel_trauma, feel_humor, feel_happiness, feel_sadness, feel_fear, feel_anger, feel_surprise, feel_disgust, feel_contempt, feel_embarrassment, feel_shame, feel_guilt, feel_excitement, feel_pride, feel_intensity, feel_coherence_tension
+  Affect dimensions: feel_valence (-1 to 1), feel_arousal (0-1), feel_dominance (0-1)
+  Functional signals (0-1): functional_salience, functional_urgency, functional_social_weight, functional_agency, functional_novelty, functional_retrieval_utility, functional_narrative_importance, functional_aesthetic_quality, functional_valence, functional_coherence_tension
+  Composite scores: feel_significance, functional_significance, total_significance
+  Core: weight, trust_score, relationship_count, version
+  REM metadata: rem_visits`,
   inputSchema: {
     type: 'object',
     properties: {
       mode: {
         type: 'string',
         enum: ['byTime', 'byDensity', 'byRating', 'byDiscovery', 'byProperty', 'bySignificance', 'byRandom', 'byBroad'],
-        description: 'Search mode',
+        description: 'Search mode: byTime (chronological), byDensity (most connected), byRating (highest rated), byDiscovery (explore mix), byProperty (sort by field), bySignificance (emotional+functional score), byRandom (random sample), byBroad (scan many truncated)',
       },
       query: { type: 'string', description: 'Optional search query' },
       sort_order: { type: 'string', enum: ['asc', 'desc'] },

package/src/tools/search-space-by.ts

@@ -12,25 +12,36 @@ export type SearchSpaceByMode = 'byTime' | 'byRating' | 'byDiscovery' | 'byPrope
 
 export const searchSpaceByTool = {
   name: 'remember_search_space_by',
-  description: `Search shared spaces using specialized modes. Similar to remember_search_by
-  but operates on published memories in spaces and groups.
+  description: `Search published memories in shared spaces/groups using specialized sort/discovery modes.
 
   Modes:
-  - byTime: Chronological sort of published memories
-  - byRating: Sort by Bayesian rating average (social ratings)
-  - byDiscovery: Interleaved rated + unrated for exploration
-  - byProperty: Sort by any property (e.g., feel_trauma, total_significance)
-  - byBroad: Massive results with truncated content
-  - byRandom: Random sampling from space
-
-  At least one of 'spaces' or 'groups' must be provided.`,
+  - byTime: Chronological sort (newest/oldest first)
+  - byRating: Sort by Bayesian rating average (social ratings from other users)
+  - byDiscovery: Interleaved rated + unrated content for exploration (4:1 ratio). Good for finding hidden gems.
+  - byProperty: Sort by any memory property (e.g., feel_trauma, total_significance, weight). Requires sort_field.
+  - byBroad: Massive results with truncated content (content_head/mid/tail ~100 chars each) for scan-and-drill-in workflow
+  - byRandom: Random sampling for serendipitous discovery
+
+  At least one of 'spaces' or 'groups' must be provided.
+
+  Use remember_search_space for hybrid semantic+keyword search of space memories.
+  Use this tool for structured browsing, sorting, and discovery of published content.
+
+  Available sort_field values for byProperty:
+  Emotions (0-1): feel_emotional_significance, feel_vulnerability, feel_trauma, feel_humor, feel_happiness, feel_sadness, feel_fear, feel_anger, feel_surprise, feel_disgust, feel_contempt, feel_embarrassment, feel_shame, feel_guilt, feel_excitement, feel_pride, feel_intensity, feel_coherence_tension
+  Affect dimensions: feel_valence (-1 to 1), feel_arousal (0-1), feel_dominance (0-1)
+  Functional signals (0-1): functional_salience, functional_urgency, functional_social_weight, functional_agency, functional_novelty, functional_retrieval_utility, functional_narrative_importance, functional_aesthetic_quality, functional_valence, functional_coherence_tension
+  Composite scores: feel_significance, functional_significance, total_significance
+  Core: weight, trust_score, relationship_count, version
+  Ratings: rating_sum, rating_count, rating_bayesian
+  Published: discovery_count, revision_count`,
   inputSchema: {
     type: 'object',
     properties: {
       mode: {
         type: 'string',
         enum: ['byTime', 'byRating', 'byDiscovery', 'byProperty', 'byBroad', 'byRandom'],
-        description: 'Search mode',
+        description: 'Search mode: byTime (chronological), byRating (highest rated), byDiscovery (explore mix), byProperty (sort by field), byBroad (scan many truncated), byRandom (random sample)',
       },
       spaces: {
         type: 'array',