cuemap-mcp 0.7.4 → 0.7.5

package/README.md

@@ -2,7 +2,7 @@
   <img src="https://cuemap.dev/cuemap-logo.PNG" alt="CueMap" width="120">
 </p>
 
-<h1 align="center">CueMap MCP Server v0.7.3</h1>
+<h1 align="center">CueMap MCP Server v0.7.5</h1>
 
 <p align="center">A premium MCP bridge for explainable, repository-aware agent memory.</p>
 
@@ -154,7 +154,7 @@ These tools are for explicit ingestion requests. Repository initialization conti
   - `cues` (string[], optional): Specific cue tags to filter the search.
   - `query_time` (string, optional): Timestamp or natural-language time anchor for v0.7 temporal query intent.
   - `depth` (number, optional): Depth of multi-hop recall expander (default: 1).
-  - `expansion_depth` (number, optional): Neighbor context expansion (default: 1). Values above 1 include nearby parent chunks or source-ordered context, using a radius of `expansion_depth - 1` when linkage exists.
+  - `expansion_depth` (number or `"conversation_round"`, optional): Neighbor context expansion (default: `"conversation_round"`). Values above 1 include nearby parent chunks or source-ordered context, using a radius of `expansion_depth - 1` when linkage exists. `"conversation_round"` prepends the message each result replies to (for an assistant reply, the user message that prompted it) when memories carry session, turn and role metadata, for example after ingesting with `segmenter: "conversation"`. The top result also gets the message that replies to it (for a user message, the assistant's answer). Memories without conversation metadata are returned as they are; pass `1` for matched memories only. A message that would also appear lower in the results is moved up instead of repeated, so fewer than `limit` results can come back.
   - `auto_reinforce` (boolean, optional): Automatically reinforce retrieved memories (default: false).
   - `min_intersection` (number, optional): Minimum required cue intersection count (default: 0).
   - `explain` (boolean, optional): Include scoring explanation data in results (default: false).

package/SKILL.md

@@ -362,10 +362,13 @@ Start with defaults. Add only the knobs that match the question.
   evidence. Unnecessary constraints can exclude useful results.
 - `depth`: keep at `1` for direct questions. Use `2` or `3` for a deliberate
   multi-hop chain; increase gradually and verify each hop.
-- `expansion_depth`: keep at `1` for the matched chunk alone. Use `2` to
-  include immediate neighboring parent chunks or source-ordered context when
-  linkage exists; larger values widen the window. This expands returned
-  content, not aliases, and adds reads and tokens to each affected hit.
+- `expansion_depth`: leave it unset. The default, `"conversation_round"`,
+  attaches the message a result replies to, and the answer to the top result,
+  when memories carry conversation metadata (for example after ingesting with
+  `segmenter: "conversation"`); other memories come back unchanged. Use `1`
+  for the matched chunk alone and the smallest output. Use `2` or more to
+  include neighboring parent chunks or source-ordered context when linkage
+  exists; this adds reads and tokens to each affected hit.
 - `disable_alias_expansion`: it defaults to `true` in the MCP wrapper. Keep it
   disabled when exactness matters. Set it to `false` only when the project has
   trustworthy aliases or the user explicitly wants related terminology.
@@ -564,7 +567,7 @@ Obtain confirmation from the user in the current interaction.
 ## Performance-aware defaults
 
 For the normal hot path, use hybrid recall with a focused query, one explicit
-project, `limit` around 3–5 initially, `depth: 1`, `expansion_depth: 1`, no automatic
+project, `limit` around 3–5 initially, `depth: 1`, the default `expansion_depth`, no automatic
 reinforcement, and no reconstruction mode unless the question needs it. Keep
 `explain` and `trace_timing` off after diagnosis.
 
@@ -577,9 +580,9 @@ semantic-model-free in the default hybrid path.
 ## Configuration and troubleshooting
 
 The MCP server launches over stdio and normally starts or attaches to a local
-embedded engine. The v0.7.3 defaults are:
+embedded engine. The v0.7.5 defaults are:
 
-- package: `cuemap-mcp@0.7.3`;
+- package: `cuemap-mcp@0.7.5`;
 - engine port: `8735`;
 - default project: stable repository-scoped identity when available;
 - logs: `~/.cuemap/server.log` unless overridden.

package/build/index.js

@@ -48,7 +48,7 @@ function defaultProjectId(cwd) {
 const DEFAULT_PROJECT = defaultProjectId(process.cwd());
 const server = new mcp_js_1.McpServer({
     name: "cuemap-mcp",
-    version: "0.7.3",
+    version: "0.7.5",
 });
 async function startEngine() {
     const configuredPort = process.env.CUEMAP_PORT
@@ -625,7 +625,7 @@ async function main() {
             metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
             structural_cues: zod_1.z.array(zod_1.z.string()).optional().describe("Normally omit: CueMap extracts structural cues automatically. Optionally add reliable source structure or a reusable category such as type:conversation."),
             embeddings: zod_1.z.array(zod_1.z.array(zod_1.z.number()).nonempty()).optional().describe("Optional one-vector-per-produced-chunk embeddings."),
-            segmenter: zod_1.z.enum(["sentence_window", "logical_block"]).optional(),
+            segmenter: zod_1.z.enum(["sentence_window", "logical_block", "conversation"]).optional().describe("How content is split. \"conversation\" is for chat histories (Claude or ChatGPT exports, JSON message lists, or transcripts whose lines start with User:/Assistant: or speaker names): one memory per message with conversation, turn and role metadata, which recall's expansion_depth \"conversation_round\" uses."),
             segment_window_size: zod_1.z.number().int().positive().optional(),
             segment_overlap: zod_1.z.number().int().nonnegative().optional(),
             segment_min_chunk_chars: zod_1.z.number().int().positive().optional(),
@@ -836,7 +836,7 @@ async function main() {
             cues: zod_1.z.array(zod_1.z.string()).optional().describe("Normally omit: CueMap generates cues from the query. Supply known tags only to deliberately narrow lexical/hybrid recall, e.g. type:conversation to search tagged conversations."),
             query_time: zod_1.z.string().optional().describe("Optional timestamp or natural-language time anchor used by v0.7 temporal query intent."),
             depth: zod_1.z.number().optional().describe("Depth of multi-hop recall. Default is 1."),
-            expansion_depth: zod_1.z.number().optional().describe("Neighbor context expansion. 1 returns the matched chunk; values above 1 include nearby parent chunks or source-ordered context with radius expansion_depth - 1 when linkage exists. Default is 1."),
+            expansion_depth: zod_1.z.union([zod_1.z.number(), zod_1.z.literal("conversation_round")]).optional().describe("Neighbor context expansion. 1 returns the matched chunk; values above 1 include nearby parent chunks or source-ordered context with radius expansion_depth - 1 when linkage exists. \"conversation_round\" prepends the message each result replies to (for an assistant reply, the user message that prompted it) and appends the answer to the top result when memories carry session, turn and role metadata. Default is \"conversation_round\"; memories without that metadata are returned as they are."),
             auto_reinforce: zod_1.z.boolean().optional().describe("Automatically reinforce retrieved memories. Default is false."),
             min_intersection: zod_1.z.number().optional().describe("Minimum intersection count for retrieval. Default is 0."),
             explain: zod_1.z.boolean().optional().describe("Include explain component for debug information in results. Default is false."),
@@ -861,7 +861,7 @@ async function main() {
         }),
     }, async (args) => {
         try {
-            const { query, limit = 10, projects, cues, query_time, response_mode = "full", preview_chars = 200, depth = 1, expansion_depth = 1, auto_reinforce = false, min_intersection, explain = false, trace_timing = false, disable_salience_bias = false, disable_alias_expansion = true, parent_fusion = "off", parent_fusion_limit = 80, parent_fusion_min_chunks = 2, ordered_reconstruction = "off", ordered_reconstruction_limit = 80, ordered_session_scan_limit = 4096, ordered_max_sessions = 3, evidence_coverage = "off", evidence_coverage_limit = 100, evidence_coverage_session_scan_limit = 4096, evidence_coverage_max_sessions = 3, disable_cuebridge_artifacts = false, cuebridge_gap_limit = 6, semantic_mode = "hybrid", query_embedding } = args;
+            const { query, limit = 10, projects, cues, query_time, response_mode = "full", preview_chars = 200, depth = 1, expansion_depth, auto_reinforce = false, min_intersection, explain = false, trace_timing = false, disable_salience_bias = false, disable_alias_expansion = true, parent_fusion = "off", parent_fusion_limit = 80, parent_fusion_min_chunks = 2, ordered_reconstruction = "off", ordered_reconstruction_limit = 80, ordered_session_scan_limit = 4096, ordered_max_sessions = 3, evidence_coverage = "off", evidence_coverage_limit = 100, evidence_coverage_session_scan_limit = 4096, evidence_coverage_max_sessions = 3, disable_cuebridge_artifacts = false, cuebridge_gap_limit = 6, semantic_mode = "hybrid", query_embedding } = args;
             const results = await client.recall({
                 query_text: query,
                 response_mode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cuemap-mcp",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "mcpName": "io.github.cuemap-dev/cuemap-mcp",
   "description": "MCP server for CueMap",
   "main": "build/index.js",
@@ -38,7 +38,7 @@
   "type": "commonjs",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "cuemap": "0.7.3",
+    "cuemap": "0.7.5",
     "zod": "^4.3.6"
   },
   "devDependencies": {
@@ -46,10 +46,10 @@
     "typescript": "^5.9.3"
   },
   "optionalDependencies": {
-    "@cuemap-dev/engine-darwin-arm64": "0.7.3",
-    "@cuemap-dev/engine-darwin-x64": "0.7.3",
-    "@cuemap-dev/engine-linux-arm64": "0.7.3",
-    "@cuemap-dev/engine-linux-x64": "0.7.3",
-    "@cuemap-dev/engine-win32-x64": "0.7.3"
+    "@cuemap-dev/engine-darwin-arm64": "0.7.5",
+    "@cuemap-dev/engine-darwin-x64": "0.7.5",
+    "@cuemap-dev/engine-linux-arm64": "0.7.5",
+    "@cuemap-dev/engine-linux-x64": "0.7.5",
+    "@cuemap-dev/engine-win32-x64": "0.7.5"
   }
 }