mcp-probe-kit 3.0.19 → 3.0.21

package/README.md

@@ -15,7 +15,7 @@
 
 > **Talk is cheap, show me the Context.**
 > 
-> mcp-probe-kit is a protocol-level toolkit designed for developers who want AI to truly understand their project's intent. It's not just a collection of 28 tools—it's a context-aware system that helps AI agents grasp what you're building.
+> mcp-probe-kit is a protocol-level toolkit designed for developers who want AI to truly understand their project's intent. It's not just a collection of 29 tools—it's a context-aware system that helps AI agents grasp what you're building.
 
 **Languages**: [English](README.md) | [简体中文](i18n/README.zh-CN.md) | [日本語](i18n/README.ja-JP.md) | [한국어](i18n/README.ko-KR.md) | [Español](i18n/README.es-ES.md) | [Français](i18n/README.fr-FR.md) | [Deutsch](i18n/README.de-DE.md) | [Português (BR)](i18n/README.pt-BR.md)
 
@@ -26,7 +26,7 @@
 
 > 🚀 AI-Powered Complete Development Toolkit - Covering the Entire Development Lifecycle
 
-A powerful MCP (Model Context Protocol) server providing **28 tools** covering the complete workflow from product analysis to final release (Requirements → Design → Development → Quality → Release), all tools support **structured output**.
+A powerful MCP (Model Context Protocol) server providing **29 tools** covering the complete workflow from product analysis to final release (Requirements → Design → Development → Quality → Release), all tools support **structured output**.
 
 **🎉 v3.0 Major Update**: Streamlined tool count, focus on core competencies, eliminate choice paralysis, let AI do more native work
 
@@ -42,7 +42,7 @@ A powerful MCP (Model Context Protocol) server providing **28 tools** covering t
 
 - [Quick Start](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html) - Setup in 5 minutes
 - [Local Memory Stack (Qdrant + Nomic Embed)](docs/memory-local-setup.md) - Docker Compose, ports `50008` / `50012`, MCP env
-- [All Tools](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - Complete list of 28 tools
+- [All Tools](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - Complete list of 29 tools
 - [Best Practices](https://mcp-probe-kit.bytezonex.com/pages/examples.html) - Full development workflow guide
 - [v3.0 Migration Guide](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - Upgrade from v2.x to v3.0
 
@@ -64,8 +64,8 @@ A powerful MCP (Model Context Protocol) server providing **28 tools** covering t
   - `init_project`, `init_project_context`, `add_feature`, `estimate`, `interview`, `ask_user`
 - **🎨 UI/UX Utilities** (3 tools) - Design systems and UI data synchronization
   - `ui_design_system`, `ui_search`, `sync_ui_data`
-- **🧠 Memory & Cursor History** (6 tools) - Reusable asset memory and local Cursor conversation retrieval
-  - `read_memory_asset`, `memorize_asset`, `scan_and_extract_patterns`, `cursor_list_conversations`, `cursor_search_conversations`, `cursor_read_conversation`
+- **🧠 Memory & Cursor History** (7 tools) - Reusable asset memory and local Cursor conversation retrieval
+  - `search_memory`, `read_memory_asset`, `memorize_asset`, `scan_and_extract_patterns`, `cursor_list_conversations`, `cursor_search_conversations`, `cursor_read_conversation`
 
 ### 🧠 Code Graph Bridge (GitNexus)
 
@@ -100,10 +100,13 @@ A powerful MCP (Model Context Protocol) server providing **28 tools** covering t
   - Linux: `~/.config/Cursor/User/globalStorage/state.vscdb`
 
 **Memory tools:**
+- `search_memory` - Semantic search across the shared memory pool (optionally prefer `type` / `tags`)
 - `memorize_asset` - Persist reusable code/spec/pattern assets into vector memory
 - `read_memory_asset` - Read full asset content by `asset_id`
 - `scan_and_extract_patterns` - Extract reusable patterns from code/file/directory before deciding whether to persist
 
+**Cross-repo memory pools:** do not rely on `source_project` / `source_path` for shared retrieval; put file paths in `content` instead. Search injection hides foreign `sourcePath` unless `MEMORY_REPO_ID` matches or `MEMORY_SEARCH_SHOW_SOURCE=true`.
+
 **Memory backend and embedding configuration:**
 - Vector database: **Qdrant**
 - **Recommended local setup:** `Qdrant (port 50008) + Infinity / nomic-embed (port 50012)` — lighter than Ollama; see **[Local Memory Stack guide](docs/memory-local-setup.md)** (中文: [memory-local-setup.zh-CN.md](docs/memory-local-setup.zh-CN.md))
@@ -121,6 +124,10 @@ A powerful MCP (Model Context Protocol) server providing **28 tools** covering t
   - `MEMORY_EMBEDDING_PROVIDER` (`ollama` by default)
   - `MEMORY_SEARCH_LIMIT` (default: `3`)
   - `MEMORY_SUMMARY_MAX_CHARS` (default: `280`)
+  - `MEMORY_SEARCH_MIN_SCORE` (default: `0` = disabled; try `0.72` for noisy pools)
+  - `MEMORY_SEARCH_SHOW_SOURCE` (default: `false`)
+  - `MEMORY_REPO_ID` (optional; show `sourcePath` only when `sourceProject` matches)
+  - `MEMORY_INJECTION_CONTENT_MAX_CHARS` (default: `1500`; max content per hit injected into `start_*` guides)
 - Behavior notes:
   - Read-only memory access only requires `MEMORY_QDRANT_URL`
   - Memory write is enabled only when `MEMORY_QDRANT_URL`, `MEMORY_EMBEDDING_URL`, and `MEMORY_EMBEDDING_MODEL` are all configured

package/build/index.js

@@ -5,7 +5,7 @@ import { InMemoryTaskMessageQueue, InMemoryTaskStore, } from "@modelcontextproto
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ProgressNotificationSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { initProject, gencommit, codeReview, codeInsight, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct, gitWorkReport, readMemoryAsset, memorizeAsset, scanAndExtractPatterns, cursorListConversations, cursorSearchConversations, cursorReadConversation } from "./tools/index.js";
+import { initProject, gencommit, codeReview, codeInsight, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct, gitWorkReport, searchMemory, readMemoryAsset, memorizeAsset, scanAndExtractPatterns, cursorListConversations, cursorSearchConversations, cursorReadConversation } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { filterTools, getToolsetFromEnv } from "./lib/toolset-manager.js";
@@ -459,6 +459,8 @@ async function executeTool(name, args, context) {
             return await startProduct((args ?? {}), context);
         case "git_work_report":
             return await gitWorkReport(args);
+        case "search_memory":
+            return await searchMemory(args);
         case "read_memory_asset":
             return await readMemoryAsset(args);
         case "memorize_asset":

package/build/lib/__tests__/agents-md-template.unit.test.js

@@ -21,5 +21,7 @@ describe('generateAgentsMdInner', () => {
         expect(md).toContain('start_bugfix');
         expect(md).toContain('memorize_asset');
         expect(md).toContain('bugfix');
+        expect(md).toContain('search_memory');
+        expect(md).toContain('自动注入');
     });
 });

package/build/lib/__tests__/memory-config.unit.test.js

@@ -30,4 +30,13 @@ describe('memory-config 单元测试', () => {
         expect(isMemoryReadEnabled(config)).toBe(true);
         expect(isMemoryEnabled(config)).toBe(true);
     });
+    test('记忆检索展示与阈值环境变量', () => {
+        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', 'true');
+        vi.stubEnv('MEMORY_SEARCH_MIN_SCORE', '0.72');
+        vi.stubEnv('MEMORY_REPO_ID', 'my-org/my-repo');
+        const config = getMemoryConfig();
+        expect(config.searchShowSource).toBe(true);
+        expect(config.searchMinScore).toBe(0.72);
+        expect(config.repoId).toBe('my-org/my-repo');
+    });
 });

package/build/lib/__tests__/memory-injection.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/lib/__tests__/memory-injection.unit.test.js

@@ -0,0 +1,51 @@
+import { afterEach, describe, expect, test, vi } from 'vitest';
+import { renderMemoryGuideSection, truncateInjectionText, } from '../memory-orchestration.js';
+afterEach(() => {
+    vi.unstubAllEnvs();
+});
+describe('memory injection auto-load', () => {
+    test('renders full asset content without asking for read_memory_asset', () => {
+        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', '');
+        vi.stubEnv('MEMORY_REPO_ID', '');
+        const section = renderMemoryGuideSection({
+            enabled: true,
+            available: true,
+            degraded: false,
+            query: 'proxy 400',
+            results: [
+                {
+                    id: 'asset-1',
+                    score: 0.88,
+                    name: 'feishu-proxy-bug',
+                    type: 'bugfix',
+                    description: 'Feishu proxy mismatch',
+                    summary: 'proxy caused 400 on HTTPS',
+                    tags: ['bugfix', 'proxy'],
+                },
+            ],
+            assetsById: {
+                'asset-1': {
+                    id: 'asset-1',
+                    name: 'feishu-proxy-bug',
+                    type: 'bugfix',
+                    description: 'Feishu proxy mismatch',
+                    summary: 'proxy caused 400 on HTTPS',
+                    content: '【现象】submit 成功但 sync_failed\n【根因】HTTP_PROXY 污染\n【修复】proxy:false',
+                    tags: ['bugfix'],
+                    confidence: 0.9,
+                    createdAt: '2026-01-01T00:00:00.000Z',
+                    updatedAt: '2026-01-01T00:00:00.000Z',
+                },
+            },
+        });
+        expect(section).toContain('已自动加载的历史经验全文');
+        expect(section).toContain('【现象】submit 成功但 sync_failed');
+        expect(section).toContain('【根因】HTTP_PROXY 污染');
+        expect(section).toContain('无需再调 `read_memory_asset`');
+        expect(section).not.toMatch(/读取: read_memory_asset/);
+    });
+    test('truncateInjectionText limits long content', () => {
+        expect(truncateInjectionText('abcdef', 4)).toBe('a...');
+        expect(truncateInjectionText('abc', 10)).toBe('abc');
+    });
+});

package/build/lib/__tests__/memory-orchestration.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/lib/__tests__/memory-orchestration.unit.test.js

@@ -0,0 +1,84 @@
+import { afterEach, describe, expect, test, vi } from 'vitest';
+import { renderMemoryGuideSection, shouldShowSourceInSearch, } from '../memory-orchestration.js';
+afterEach(() => {
+    vi.unstubAllEnvs();
+});
+describe('memory-orchestration', () => {
+    test('does not show source path by default', () => {
+        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', '');
+        vi.stubEnv('MEMORY_REPO_ID', '');
+        const section = renderMemoryGuideSection({
+            enabled: true,
+            available: true,
+            degraded: false,
+            query: '404 submit',
+            results: [
+                {
+                    id: '1',
+                    score: 0.91,
+                    name: 'purchase-create-submit-404',
+                    type: 'bugfix',
+                    description: 'desc',
+                    summary: 'summary',
+                    tags: ['bugfix'],
+                    sourceProject: 'zhixing/gongyingshang',
+                    sourcePath: 'admin-api/app.js',
+                },
+            ],
+            assetsById: {},
+        });
+        expect(section).toContain('purchase-create-submit-404');
+        expect(section).not.toContain('admin-api/app.js');
+        expect(section).not.toContain('来源:');
+    });
+    test('shows source path when MEMORY_REPO_ID matches', () => {
+        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', '');
+        vi.stubEnv('MEMORY_REPO_ID', 'zhixing/gongyingshang');
+        expect(shouldShowSourceInSearch({
+            id: '1',
+            score: 0.9,
+            name: 'x',
+            type: 'bugfix',
+            description: '',
+            summary: '',
+            tags: [],
+            sourceProject: 'zhixing/gongyingshang',
+            sourcePath: 'admin-api/app.js',
+        })).toBe(true);
+        expect(shouldShowSourceInSearch({
+            id: '2',
+            score: 0.9,
+            name: 'y',
+            type: 'bugfix',
+            description: '',
+            summary: '',
+            tags: [],
+            sourceProject: 'other/repo',
+            sourcePath: 'src/index.ts',
+        })).toBe(false);
+    });
+    test('MEMORY_SEARCH_SHOW_SOURCE=true always shows source', () => {
+        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', 'true');
+        vi.stubEnv('MEMORY_REPO_ID', '');
+        const section = renderMemoryGuideSection({
+            enabled: true,
+            available: true,
+            degraded: false,
+            query: 'q',
+            results: [
+                {
+                    id: '1',
+                    score: 0.8,
+                    name: 'n',
+                    type: 'bugfix',
+                    description: '',
+                    summary: 's',
+                    tags: [],
+                    sourcePath: 'admin-api/app.js',
+                },
+            ],
+            assetsById: {},
+        });
+        expect(section).toContain('来源: admin-api/app.js');
+    });
+});

package/build/lib/__tests__/memory-payload.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/lib/__tests__/memory-payload.unit.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, test } from 'vitest';
+import { normalizeMemoryPayload, payloadToMemoryFields } from '../memory-payload.js';
+describe('memory-payload', () => {
+    test('maps legacy kind/title/source fields to current schema', () => {
+        const normalized = normalizeMemoryPayload({
+            kind: 'extracted_pattern',
+            title: 'Feishu submit success but sync_failed',
+            source: 'scan_and_extract_patterns-fallback',
+            content: 'Pattern: proxy mismatch',
+            tags: ['feishu', 'pattern'],
+            created_at: '2026-05-25T11:20:06.705Z',
+        });
+        expect(normalized.name).toBe('Feishu submit success but sync_failed');
+        expect(normalized.type).toBe('pattern');
+        expect(normalized.summary).toContain('Pattern');
+        expect(normalized.createdAt).toBe('2026-05-25T11:20:06.705Z');
+    });
+    test('payloadToMemoryFields preserves standard asset fields', () => {
+        const fields = payloadToMemoryFields({
+            id: 'asset-1',
+            name: 'purchase-create-submit-404',
+            type: 'bugfix',
+            description: '送审 404',
+            summary: 'res.data.purchase.id',
+            content: '【现象】404',
+            tags: ['bugfix'],
+            confidence: 0.95,
+            createdAt: '2026-05-27T04:28:04.684Z',
+            updatedAt: '2026-05-27T04:28:04.684Z',
+        });
+        expect(fields.name).toBe('purchase-create-submit-404');
+        expect(fields.type).toBe('bugfix');
+        expect(fields.tags).toEqual(['bugfix']);
+    });
+});

package/build/lib/agents-md-template.js

@@ -6,14 +6,16 @@ function memorySection(locale) {
     if (locale === "zh-CN") {
         return `
 记忆（需 MEMORY_QDRANT_URL 等已配置）：
-- 检索：\`start_feature\` / \`start_bugfix\` / \`start_ui\` 会自动搜记忆；命中后用 \`read_memory_asset\` 读全文再动手
-- Bug 修完验证通过后 → **必须** \`memorize_asset\` type=\`bugfix\` tags=\`bugfix,root-cause\`（现象+根因+改法）
-- 功能/UI 有可复用产出 → \`memorize_asset\` type=\`pattern\`/\`component\``;
+- 检索：\`start_*\` 命中后**自动注入**历史经验全文；中途补查可用 \`search_memory\`；单条精读仍可用 \`read_memory_asset\`
+- 沉淀：跨仓库共享**勿填** source_project/source_path；路径写进 content；summary 写检索关键词
+- Bug 修完验证通过 → **必须** \`memorize_asset\` type=\`bugfix\` tags=\`bugfix,root-cause\`（content 含【现象】【根因】【修复】【验证】）
+- 功能/UI 可复用产出 → \`memorize_asset\` type=\`pattern\`/\`component\``;
     }
     return `
 Memory (requires MEMORY_* env):
-- Search: \`start_feature\` / \`start_bugfix\` / \`start_ui\` auto-search; use \`read_memory_asset\` on hits before coding
-- After verified bugfix → MUST \`memorize_asset\` type=\`bugfix\` tags=\`bugfix,root-cause\` (symptom + root cause + fix)
+- Search: \`start_*\` auto-injects full memory hits; use \`search_memory\` mid-task; \`read_memory_asset\` for a specific id
+- Store: do NOT use source_project/source_path for cross-repo pools; put paths in content; write keyword-rich summary
+- After verified bugfix → MUST \`memorize_asset\` type=\`bugfix\` (sections: symptom, root cause, fix, verification)
 - Reusable feature/UI → \`memorize_asset\` type=\`pattern\`/\`component\``;
 }
 /**

package/build/lib/memory-client.d.ts

@@ -24,8 +24,15 @@ export interface MemorySearchResult {
     description: string;
     summary: string;
     tags: string[];
+    sourceProject?: string;
     sourcePath?: string;
 }
+export interface MemorySearchOptions {
+    limit?: number;
+    minScore?: number;
+    preferTypes?: string[];
+    preferTags?: string[];
+}
 export declare function normalizeContentForHash(content: string): string;
 export declare function sha256Hex(value: string): string;
 export declare function buildMemoryContentHashes(content: string): {
@@ -55,7 +62,7 @@ export declare class MemoryClient {
         sourcePath?: string;
         usage?: string;
     }): Promise<MemoryAsset>;
-    search(query: string, limit?: number): Promise<MemorySearchResult[]>;
+    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
     getAsset(assetId: string): Promise<MemoryAsset | null>;
 }
 export declare function createMemoryClient(): MemoryClient;

package/build/lib/memory-client.js

@@ -1,5 +1,6 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { getMemoryConfig, isMemoryEnabled, isMemoryReadEnabled } from './memory-config.js';
+import { normalizeMemoryPayload, payloadToMemoryFields } from './memory-payload.js';
 function truncate(value, maxChars) {
     if (value.length <= maxChars) {
         return value;
@@ -155,26 +156,14 @@ export class MemoryClient {
                 },
             }),
         });
-        const payload = data.result?.points?.[0]?.payload;
-        if (!payload) {
+        const rawPayload = data.result?.points?.[0]?.payload;
+        if (!rawPayload) {
             return null;
         }
+        const fields = payloadToMemoryFields(rawPayload);
         return {
-            id: String(payload.id || ''),
-            name: String(payload.name || ''),
-            type: String(payload.type || ''),
-            description: String(payload.description || ''),
-            summary: String(payload.summary || ''),
-            content: String(payload.content || ''),
-            tags: ensureArray(payload.tags),
-            confidence: numberOr(payload.confidence, 0.5),
-            sourceProject: typeof payload.sourceProject === 'string' ? payload.sourceProject : undefined,
-            sourcePath: typeof payload.sourcePath === 'string' ? payload.sourcePath : undefined,
-            usage: typeof payload.usage === 'string' ? payload.usage : undefined,
-            contentHash: typeof payload.contentHash === 'string' ? payload.contentHash : undefined,
-            normalizedContentHash: typeof payload.normalizedContentHash === 'string' ? payload.normalizedContentHash : undefined,
-            createdAt: String(payload.createdAt || ''),
-            updatedAt: String(payload.updatedAt || ''),
+            ...fields,
+            id: fields.id || String(rawPayload.id || ''),
         };
     }
     async upsertAsset(input) {
@@ -229,33 +218,41 @@ export class MemoryClient {
         });
         return asset;
     }
-    async search(query, limit = this.config.searchLimit) {
+    async search(query, options = {}) {
         if (!this.isEnabled()) {
             return [];
         }
+        const limit = options.limit ?? this.config.searchLimit;
+        const minScore = options.minScore ?? this.config.searchMinScore;
+        const fetchLimit = Math.min(Math.max(limit * 4, limit), 50);
         const vector = await this.embed(query);
         const data = await this.requestJson(`${this.config.qdrantUrl}/collections/${encodeURIComponent(this.config.qdrantCollection)}/points/search`, {
             method: 'POST',
             headers: this.buildHeaders(),
             body: JSON.stringify({
                 vector,
-                limit,
+                limit: fetchLimit,
                 with_payload: true,
             }),
         });
-        return (data.result || []).map((point) => {
-            const payload = point.payload || {};
+        const mapped = (data.result || []).map((point) => {
+            const payload = normalizeMemoryPayload(point.payload || {});
+            const fields = payloadToMemoryFields(payload);
             return {
                 id: String(point.id),
                 score: numberOr(point.score, 0),
-                name: String(payload.name || ''),
-                type: String(payload.type || ''),
-                description: String(payload.description || ''),
-                summary: truncate(String(payload.summary || ''), this.config.summaryMaxChars),
-                tags: ensureArray(payload.tags),
-                sourcePath: typeof payload.sourcePath === 'string' ? payload.sourcePath : undefined,
+                name: fields.name,
+                type: fields.type,
+                description: fields.description,
+                summary: truncate(fields.summary, this.config.summaryMaxChars),
+                tags: fields.tags,
+                sourceProject: fields.sourceProject,
+                sourcePath: fields.sourcePath,
             };
         });
+        const ranked = rankSearchResults(mapped, options.preferTypes, options.preferTags);
+        const filtered = minScore > 0 ? ranked.filter((item) => item.score >= minScore) : ranked;
+        return filtered.slice(0, limit);
     }
     async getAsset(assetId) {
         if (!this.isReadEnabled()) {
@@ -265,29 +262,41 @@ export class MemoryClient {
             method: 'GET',
             headers: this.buildHeaders(false),
         });
-        const payload = data.result?.payload;
-        if (!payload) {
+        const rawPayload = data.result?.payload;
+        if (!rawPayload) {
             return null;
         }
+        const fields = payloadToMemoryFields(rawPayload);
         return {
-            id: String(payload.id || assetId),
-            name: String(payload.name || ''),
-            type: String(payload.type || ''),
-            description: String(payload.description || ''),
-            summary: String(payload.summary || ''),
-            content: String(payload.content || ''),
-            tags: ensureArray(payload.tags),
-            confidence: numberOr(payload.confidence, 0.5),
-            sourceProject: typeof payload.sourceProject === 'string' ? payload.sourceProject : undefined,
-            sourcePath: typeof payload.sourcePath === 'string' ? payload.sourcePath : undefined,
-            usage: typeof payload.usage === 'string' ? payload.usage : undefined,
-            contentHash: typeof payload.contentHash === 'string' ? payload.contentHash : undefined,
-            normalizedContentHash: typeof payload.normalizedContentHash === 'string' ? payload.normalizedContentHash : undefined,
-            createdAt: String(payload.createdAt || ''),
-            updatedAt: String(payload.updatedAt || ''),
+            ...fields,
+            id: fields.id || assetId,
         };
     }
 }
+function rankSearchResults(results, preferTypes = [], preferTags = []) {
+    if (preferTypes.length === 0 && preferTags.length === 0) {
+        return [...results].sort((a, b) => b.score - a.score);
+    }
+    const preferredTypes = new Set(preferTypes.map((item) => item.toLowerCase()));
+    const preferredTags = new Set(preferTags.map((item) => item.toLowerCase()));
+    const scoreBoost = (item) => {
+        let boost = 0;
+        if (preferredTypes.has(item.type.toLowerCase())) {
+            boost += 2;
+        }
+        if (item.tags.some((tag) => preferredTags.has(tag.toLowerCase()))) {
+            boost += 1;
+        }
+        return boost;
+    };
+    return [...results].sort((a, b) => {
+        const boostDiff = scoreBoost(b) - scoreBoost(a);
+        if (boostDiff !== 0) {
+            return boostDiff;
+        }
+        return b.score - a.score;
+    });
+}
 export function createMemoryClient() {
     return new MemoryClient();
 }

package/build/lib/memory-config.d.ts

@@ -8,6 +8,14 @@ export interface MemoryConfig {
     embeddingProvider: 'ollama' | 'openai-compatible';
     searchLimit: number;
     summaryMaxChars: number;
+    /** Show sourcePath in search injection (default false for cross-repo pools) */
+    searchShowSource: boolean;
+    /** Minimum cosine score to include in search results; 0 = disabled */
+    searchMinScore: number;
+    /** When set, show sourcePath only if payload.sourceProject matches */
+    repoId: string;
+    /** Max chars of each asset content injected into start_* guides */
+    injectionContentMaxChars: number;
 }
 export declare function getMemoryConfig(): MemoryConfig;
 export declare function isMemoryEnabled(config?: MemoryConfig): boolean;

package/build/lib/memory-config.js

@@ -9,6 +9,21 @@ function getNumberEnv(name, fallback) {
     const parsed = Number(raw);
     return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
+function getOptionalNumberEnv(name, fallback) {
+    const raw = process.env[name]?.trim();
+    if (!raw) {
+        return fallback;
+    }
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+function getBooleanEnv(name, fallback) {
+    const raw = process.env[name]?.trim().toLowerCase();
+    if (!raw) {
+        return fallback;
+    }
+    return raw === '1' || raw === 'true' || raw === 'yes' || raw === 'on';
+}
 export function getMemoryConfig() {
     const provider = (process.env.MEMORY_EMBEDDING_PROVIDER || 'ollama').trim().toLowerCase();
     return {
@@ -21,6 +36,10 @@ export function getMemoryConfig() {
         embeddingProvider: provider === 'openai-compatible' ? 'openai-compatible' : 'ollama',
         searchLimit: getNumberEnv('MEMORY_SEARCH_LIMIT', 3),
         summaryMaxChars: getNumberEnv('MEMORY_SUMMARY_MAX_CHARS', 280),
+        searchShowSource: getBooleanEnv('MEMORY_SEARCH_SHOW_SOURCE', false),
+        searchMinScore: getOptionalNumberEnv('MEMORY_SEARCH_MIN_SCORE', 0),
+        repoId: (process.env.MEMORY_REPO_ID || '').trim(),
+        injectionContentMaxChars: getNumberEnv('MEMORY_INJECTION_CONTENT_MAX_CHARS', 1500),
     };
 }
 export function isMemoryEnabled(config = getMemoryConfig()) {

package/build/lib/memory-orchestration.d.ts

@@ -1,4 +1,5 @@
-import type { MemorySearchResult } from './memory-client.js';
+import type { MemoryAsset, MemorySearchResult } from './memory-client.js';
+import { type MemoryConfig } from './memory-config.js';
 export type MemoryPlanKind = 'feature' | 'bugfix' | 'ui' | 'default';
 export interface MemoryInjectionContext {
     enabled: boolean;
@@ -6,9 +7,13 @@ export interface MemoryInjectionContext {
     degraded: boolean;
     query: string;
     results: MemorySearchResult[];
+    /** Full assets keyed by search hit id (auto-loaded for start_* injection) */
+    assetsById: Record<string, MemoryAsset>;
     error?: string;
 }
-export declare function loadMemoryInjectionContext(query: string): Promise<MemoryInjectionContext>;
+export declare function truncateInjectionText(value: string, maxChars: number): string;
+export declare function loadMemoryInjectionContext(query: string, kind?: MemoryPlanKind): Promise<MemoryInjectionContext>;
+export declare function shouldShowSourceInSearch(item: MemorySearchResult, config?: MemoryConfig): boolean;
 export declare function renderMemoryGuideSection(context: MemoryInjectionContext): string;
 export declare function buildMemoryPlanStep(kind?: MemoryPlanKind): {
     id: string;