@zokizuan/satori-mcp 3.2.0 → 3.4.0

package/dist/core/handlers.d.ts

@@ -16,6 +16,9 @@ export declare class ToolHandlers {
     constructor(context: Context, snapshotManager: SnapshotManager, syncManager: SyncManager, runtimeFingerprint: IndexFingerprint, now?: () => number, callGraphManager?: CallGraphSidecarManager);
     private buildReindexInstruction;
     private buildReindexHint;
+    private summarizeFingerprint;
+    private buildCompatibilityDiagnostics;
+    private buildCompatibilityStatusLines;
     private buildRequiresReindexPayload;
     private buildRequiresReindexSearchResponse;
     private buildRequiresReindexCallGraphPayload;
@@ -46,6 +49,9 @@ export declare class ToolHandlers {
     private getOutlineStatusForLanguage;
     private sortFileOutlineSymbols;
     private buildSearchPassWarning;
+    private isSearchPassFaultInjectionEnabled;
+    private getForcedFailedSearchPassId;
+    private shouldForceSearchPassFailure;
     private mapCallGraphStatus;
     private getContextIgnorePatterns;
     private rebuildCallGraphForIndex;
@@ -196,7 +202,19 @@ export declare class ToolHandlers {
         }[];
         isError: boolean;
     }>;
-    handleGetIndexingStatus(args: any): Promise<any>;
+    handleGetIndexingStatus(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
     /**
      * Handle sync request - manually trigger incremental sync for a codebase
      */

package/dist/core/handlers.js

@@ -119,6 +119,46 @@ export class ToolHandlers {
             }
         };
     }
+    summarizeFingerprint(fingerprint) {
+        return `${fingerprint.embeddingProvider}/${fingerprint.embeddingModel}/${fingerprint.embeddingDimension}/${fingerprint.vectorStoreProvider}/${fingerprint.schemaVersion}`;
+    }
+    buildCompatibilityDiagnostics(codebasePath) {
+        const info = typeof this.snapshotManager.getCodebaseInfo === 'function'
+            ? this.snapshotManager.getCodebaseInfo(codebasePath)
+            : undefined;
+        const statusAtCheck = info?.status
+            || (typeof this.snapshotManager.getCodebaseStatus === 'function'
+                ? this.snapshotManager.getCodebaseStatus(codebasePath)
+                : 'not_found');
+        const diagnostics = {
+            runtimeFingerprint: this.runtimeFingerprint,
+            statusAtCheck
+        };
+        if (info?.indexFingerprint) {
+            diagnostics.indexedFingerprint = info.indexFingerprint;
+        }
+        if (info?.fingerprintSource) {
+            diagnostics.fingerprintSource = info.fingerprintSource;
+        }
+        if (info?.reindexReason) {
+            diagnostics.reindexReason = info.reindexReason;
+        }
+        return diagnostics;
+    }
+    buildCompatibilityStatusLines(codebasePath) {
+        const diagnostics = this.buildCompatibilityDiagnostics(codebasePath);
+        let lines = `\n🧬 Runtime fingerprint: ${this.summarizeFingerprint(diagnostics.runtimeFingerprint)}`;
+        lines += diagnostics.indexedFingerprint
+            ? `\n🧬 Indexed fingerprint: ${this.summarizeFingerprint(diagnostics.indexedFingerprint)}`
+            : `\n🧬 Indexed fingerprint: unavailable`;
+        if (diagnostics.fingerprintSource) {
+            lines += `\n🧬 Fingerprint source: ${diagnostics.fingerprintSource}`;
+        }
+        if (diagnostics.reindexReason) {
+            lines += `\n🧬 Reindex reason: ${diagnostics.reindexReason}`;
+        }
+        return lines;
+    }
     buildRequiresReindexPayload(codebasePath, detail, searchContext) {
         const detailLine = detail ? `${detail}\n\n` : '';
         const base = searchContext ? {
@@ -140,7 +180,8 @@ export class ToolHandlers {
             message: `${detailLine}The index at '${codebasePath}' is incompatible with the current runtime and must be rebuilt. Please run manage_index with {\"action\":\"reindex\",\"path\":\"${codebasePath}\"}.`,
             hints: {
                 reindex: this.buildReindexHint(codebasePath)
-            }
+            },
+            compatibility: this.buildCompatibilityDiagnostics(codebasePath)
         };
     }
     buildRequiresReindexSearchResponse(codebasePath, detail, searchContext) {
@@ -172,7 +213,8 @@ export class ToolHandlers {
             message: `${detailLine}The index at '${codebasePath}' is incompatible with the current runtime and must be rebuilt. Please run manage_index with {"action":"reindex","path":"${codebasePath}"}.`,
             hints: {
                 reindex: this.buildReindexHint(codebasePath)
-            }
+            },
+            compatibility: this.buildCompatibilityDiagnostics(codebasePath)
         };
     }
     getMatchingBlockedRoot(absolutePath) {
@@ -498,6 +540,28 @@ export class ToolHandlers {
     buildSearchPassWarning(passId) {
         return `SEARCH_PASS_FAILED:${passId} - ${passId} semantic search pass failed; results may be degraded.`;
     }
+    isSearchPassFaultInjectionEnabled() {
+        return process.env.NODE_ENV === 'test';
+    }
+    getForcedFailedSearchPassId() {
+        if (!this.isSearchPassFaultInjectionEnabled()) {
+            return undefined;
+        }
+        const raw = typeof process.env.SATORI_TEST_FAIL_SEARCH_PASS === 'string'
+            ? process.env.SATORI_TEST_FAIL_SEARCH_PASS.trim().toLowerCase()
+            : '';
+        if (raw === 'primary' || raw === 'expanded' || raw === 'both') {
+            return raw;
+        }
+        return undefined;
+    }
+    shouldForceSearchPassFailure(passId) {
+        const forced = this.getForcedFailedSearchPassId();
+        if (!forced) {
+            return false;
+        }
+        return forced === 'both' || forced === passId;
+    }
     mapCallGraphStatus(graph) {
         if (graph.supported) {
             return 'ok';
@@ -1386,7 +1450,11 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
                 { id: 'expanded', query: expandedQuery },
             ];
             searchDiagnostics.searchPassCount = passDescriptors.length;
-            const passSettled = await Promise.allSettled(passDescriptors.map((pass) => {
+            const passSettled = await Promise.allSettled(passDescriptors.map(async (pass) => {
+                const passId = pass.id;
+                if (this.shouldForceSearchPassFailure(passId)) {
+                    throw new Error(`FORCED_TEST_SEARCH_PASS_FAILURE:${passId}`);
+                }
                 return this.context.semanticSearch(effectiveRoot, pass.query, candidateLimit, 0.3);
             }));
             const searchWarnings = [];
@@ -2105,7 +2173,17 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
             // Check indexing status using new status system
             const statusGate = this.enforceFingerprintGate(absolutePath);
             if (statusGate.blockedResponse) {
-                return statusGate.blockedResponse;
+                const statusMessage = this.buildReindexInstruction(absolutePath, statusGate.message);
+                const compatibilityStatus = this.buildCompatibilityStatusLines(absolutePath);
+                const pathInfo = codebasePath !== absolutePath
+                    ? `\nNote: Input path '${codebasePath}' was resolved to absolute path '${absolutePath}'`
+                    : '';
+                return {
+                    content: [{
+                            type: "text",
+                            text: statusMessage + compatibilityStatus + pathInfo
+                        }]
+                };
             }
             const status = this.snapshotManager.getCodebaseStatus(absolutePath);
             const info = this.snapshotManager.getCodebaseInfo(absolutePath);
@@ -2178,10 +2256,11 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
             const pathInfo = codebasePath !== absolutePath
                 ? `\nNote: Input path '${codebasePath}' was resolved to absolute path '${absolutePath}'`
                 : '';
+            const compatibilityStatus = this.buildCompatibilityStatusLines(absolutePath);
             return {
                 content: [{
                         type: "text",
-                        text: statusMessage + pathInfo
+                        text: statusMessage + compatibilityStatus + pathInfo
                     }]
             };
         }

package/dist/core/search-types.d.ts

@@ -1,5 +1,6 @@
 import { FreshnessDecision } from "./sync.js";
 import { SearchGroupBy, SearchResultMode, SearchScope } from "./search-constants.js";
+import { FingerprintSource, IndexFingerprint } from "../config.js";
 export type StalenessBucket = "fresh" | "aging" | "stale" | "unknown";
 export interface SearchSpan {
     startLine: number;
@@ -57,6 +58,13 @@ export interface SearchGroupResult {
         topChunkScore: number;
     };
 }
+export interface FingerprintCompatibilityDiagnostics {
+    runtimeFingerprint: IndexFingerprint;
+    indexedFingerprint?: IndexFingerprint;
+    fingerprintSource?: FingerprintSource;
+    reindexReason?: "legacy_unverified_fingerprint" | "fingerprint_mismatch" | "missing_fingerprint";
+    statusAtCheck?: "indexed" | "indexing" | "indexfailed" | "sync_completed" | "requires_reindex" | "not_found";
+}
 interface SearchBaseResponseEnvelope {
     status: "ok" | "requires_reindex" | "not_indexed";
     path: string;
@@ -70,6 +78,7 @@ interface SearchBaseResponseEnvelope {
     warnings?: string[];
     message?: string;
     hints?: Record<string, unknown>;
+    compatibility?: FingerprintCompatibilityDiagnostics;
 }
 export interface SearchGroupedResponseEnvelope extends SearchBaseResponseEnvelope {
     resultMode: "grouped";

package/dist/tools/call_graph.js

@@ -21,7 +21,15 @@ export const callGraphTool = {
     description: () => 'Traverse the prebuilt TS/Python call graph sidecar for callers/callees/bidirectional symbol relationships.',
     inputSchemaZod: () => callGraphInputSchema,
     execute: async (args, ctx) => {
-        const parsed = callGraphInputSchema.safeParse(args || {});
+        const normalizedArgs = (args && typeof args === 'object')
+            ? { ...args }
+            : (args || {});
+        if (normalizedArgs
+            && typeof normalizedArgs === 'object'
+            && normalizedArgs.direction === 'bidirectional') {
+            normalizedArgs.direction = 'both';
+        }
+        const parsed = callGraphInputSchema.safeParse(normalizedArgs);
         if (!parsed.success) {
             return {
                 content: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zokizuan/satori-mcp",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "MCP server for Satori with agent-safe semantic search and indexing",
   "type": "module",
   "main": "dist/index.js",