@zokizuan/satori-mcp 4.11.1 → 4.11.2

package/README.md

@@ -7,8 +7,8 @@ Read-only MCP server for Satori. It gives coding agents six deterministic tools
 Use the CLI installer for normal setup:
 
 ```bash
-npx -y @zokizuan/satori-cli@0.4.1 install --client all
-npx -y @zokizuan/satori-cli@0.4.1 doctor
+npx -y @zokizuan/satori-cli@0.4.2 install --client all
+npx -y @zokizuan/satori-cli@0.4.2 doctor
 ```
 
 The CLI installer supports `codex`, `claude`, `opencode`, and `all`. It creates the runtime cache, writes the stable launcher, and writes client config for you. Avoid using `npx` as the resident MCP server command; first-run package resolution can exceed normal MCP startup timeouts.
@@ -16,7 +16,7 @@ The CLI installer supports `codex`, `claude`, `opencode`, and `all`. It creates
 Advanced direct execution is available through the package bin:
 
 ```bash
-npx -y @zokizuan/satori-mcp@4.11.1 --help
+npx -y @zokizuan/satori-mcp@4.11.2 --help
 ```
 
 Use direct package execution for inspection, smoke tests, or unsupported harnesses. For supported clients, prefer `satori-cli install` so startup does not depend on package-manager resolution.

package/dist/config.js

@@ -209,7 +209,7 @@ Environment Variables:
 
 Examples:
   # Install resident MCP config without package-manager startup on every client launch
-  npx -y @zokizuan/satori-cli@0.4.1 install --client all
+  npx -y @zokizuan/satori-cli@0.4.2 install --client all
 
   # Start MCP server with OpenAI and explicit Milvus address
   OPENAI_API_KEY=sk-xxx MILVUS_ADDRESS=localhost:19530 satori

package/dist/core/handlers.d.ts

@@ -116,6 +116,7 @@ export declare class ToolHandlers {
     private collapseDuplicateDeclarationGroups;
     private buildFallbackGroupId;
     private isCallGraphLanguageSupported;
+    private loadCallGraphSidecarForSearch;
     private buildCallGraphHint;
     private sanitizeIndexedRelativeFilePath;
     private buildNavigationFallback;

package/dist/core/handlers.js

@@ -1905,20 +1905,60 @@ export class ToolHandlers {
         }
         return false;
     }
-    buildCallGraphHint(file, span, language, symbolId, symbolLabel) {
+    loadCallGraphSidecarForSearch(codebaseRoot) {
+        const loadSidecar = this.callGraphManager?.loadSidecar;
+        if (typeof loadSidecar !== 'function') {
+            return null;
+        }
+        const sidecar = loadSidecar.call(this.callGraphManager, codebaseRoot);
+        if (!sidecar || !Array.isArray(sidecar.nodes)) {
+            return null;
+        }
+        return {
+            builtAt: typeof sidecar.builtAt === 'string' ? sidecar.builtAt : undefined,
+            nodes: sidecar.nodes,
+        };
+    }
+    buildCallGraphHint(file, language, sidecar, symbolId, symbolLabel) {
         if (!symbolId) {
             return { supported: false, reason: 'missing_symbol' };
         }
         if (!this.isCallGraphLanguageSupported(language, file)) {
             return { supported: false, reason: 'unsupported_language' };
         }
+        if (!sidecar) {
+            return { supported: false, reason: 'missing_sidecar' };
+        }
+        const normalizedFile = this.sanitizeIndexedRelativeFilePath(file);
+        if (!normalizedFile) {
+            return { supported: false, reason: 'stale_symbol_ref' };
+        }
+        const sidecarNode = sidecar.nodes.find((node) => node.symbolId === symbolId);
+        const normalizedSidecarFile = sidecarNode ? this.sanitizeIndexedRelativeFilePath(sidecarNode.file) : undefined;
+        const sidecarSpan = sidecarNode?.span;
+        if (!sidecarNode ||
+            normalizedSidecarFile !== normalizedFile ||
+            !sidecarSpan ||
+            !Number.isFinite(sidecarSpan.startLine) ||
+            !Number.isFinite(sidecarSpan.endLine)) {
+            return { supported: false, reason: 'stale_symbol_ref' };
+        }
+        const safeStartLine = Math.max(1, Number(sidecarSpan.startLine));
+        const safeEndLine = Math.max(safeStartLine, Number(sidecarSpan.endLine));
+        const validatedAt = new Date(this.now()).toISOString();
         return {
             supported: true,
+            validated: true,
+            validatedAt,
+            sidecarBuiltAt: sidecar.builtAt || validatedAt,
             symbolRef: {
-                file,
+                file: normalizedSidecarFile,
                 symbolId,
-                symbolLabel: symbolLabel || undefined,
-                span
+                symbolLabel: sidecarNode.symbolLabel || symbolLabel || undefined,
+                span: {
+                    startLine: safeStartLine,
+                    endLine: safeEndLine
+                }
             }
         };
     }
@@ -1978,12 +2018,13 @@ export class ToolHandlers {
         if (!callGraphHint.supported) {
             return undefined;
         }
-        const normalizedFile = this.sanitizeIndexedRelativeFilePath(relativeFilePath);
+        const normalizedFile = this.sanitizeIndexedRelativeFilePath(callGraphHint.symbolRef.file || relativeFilePath);
         if (!normalizedFile) {
             return undefined;
         }
-        const safeStartLine = Number.isFinite(span.startLine) ? Math.max(1, Number(span.startLine)) : 1;
-        const safeEndLine = Number.isFinite(span.endLine) ? Math.max(safeStartLine, Number(span.endLine)) : safeStartLine;
+        const actionSpan = callGraphHint.symbolRef.span || span;
+        const safeStartLine = Number.isFinite(actionSpan.startLine) ? Math.max(1, Number(actionSpan.startLine)) : 1;
+        const safeEndLine = Number.isFinite(actionSpan.endLine) ? Math.max(safeStartLine, Number(actionSpan.endLine)) : safeStartLine;
         const absolutePath = path.resolve(codebaseRoot, normalizedFile);
         const symbolRef = {
             ...callGraphHint.symbolRef,
@@ -3730,6 +3771,7 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
                 ? this.snapshotManager.getCodebaseCallGraphSidecar(effectiveRoot)
                 : undefined;
             const sidecarReadyForOutline = Boolean(sidecarInfo && sidecarInfo.version === 'v3');
+            const callGraphSidecar = sidecarReadyForOutline ? this.loadCallGraphSidecarForSearch(effectiveRoot) : null;
             const groupedResults = [];
             for (const group of groups.values()) {
                 exactMatchPinningApplied = this.sortSearchCandidates(group.chunks, queryPlan.exactMatchPinningEnabled, parsedOperators.must.length > 0) || exactMatchPinningApplied;
@@ -3750,7 +3792,7 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
                 const repSymbolId = typeof representative.result.symbolId === 'string' ? representative.result.symbolId : null;
                 const repSymbolLabel = typeof representative.result.symbolLabel === 'string' ? representative.result.symbolLabel : null;
                 const groupId = repSymbolId || this.buildFallbackGroupId(representative.result.relativePath, span);
-                const callGraphHint = this.buildCallGraphHint(representative.result.relativePath, span, representative.result.language || 'unknown', repSymbolId || undefined, repSymbolLabel || undefined);
+                const callGraphHint = this.buildCallGraphHint(representative.result.relativePath, representative.result.language || 'unknown', callGraphSidecar, repSymbolId || undefined, repSymbolLabel || undefined);
                 const navigationFallback = this.buildNavigationFallback(effectiveRoot, representative.result.relativePath, span, callGraphHint, sidecarReadyForOutline);
                 const nextActions = this.buildSearchNextActions(effectiveRoot, representative.result.relativePath, span, callGraphHint, sidecarReadyForOutline);
                 groupedResults.push({
@@ -4063,6 +4105,7 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
                 const endsAfterWindowStart = windowStart === undefined || node.span.endLine >= windowStart;
                 return startsBeforeWindowEnd && endsAfterWindowStart;
             });
+            const outlineValidatedAt = new Date(this.now()).toISOString();
             const symbols = this.sortFileOutlineSymbols(windowed.map((node) => {
                 const symbolLabel = (typeof node.symbolLabel === 'string' && node.symbolLabel.trim().length > 0)
                     ? node.symbolLabel
@@ -4076,6 +4119,9 @@ To force rebuild from scratch: call manage_index with {"action":"create","path":
                     },
                     callGraphHint: {
                         supported: true,
+                        validated: true,
+                        validatedAt: outlineValidatedAt,
+                        sidecarBuiltAt: sidecar.builtAt,
                         symbolRef: {
                             file: normalizedFile,
                             symbolId: node.symbolId,

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

@@ -15,9 +15,12 @@ export interface CallGraphSymbolRef {
 export type CallGraphHint = {
     supported: true;
     symbolRef: CallGraphSymbolRef;
+    validated: true;
+    validatedAt: string;
+    sidecarBuiltAt: string;
 } | {
     supported: false;
-    reason: "missing_symbol" | "unsupported_language";
+    reason: "missing_symbol" | "unsupported_language" | "missing_sidecar" | "stale_symbol_ref";
 };
 export interface SearchNextActionReadSymbol {
     tool: "read_file";
@@ -334,10 +337,9 @@ export interface FileOutlineSymbolResult {
     symbolId: string;
     symbolLabel: string;
     span: SearchSpan;
-    callGraphHint: {
+    callGraphHint: Extract<CallGraphHint, {
         supported: true;
-        symbolRef: CallGraphSymbolRef;
-    };
+    }>;
 }
 export interface FileOutlineResponseEnvelope {
     status: FileOutlineStatus;

package/dist/server/bootstrap-stdio.js

@@ -2,6 +2,7 @@ import { installCliStdoutRedirect, installConsoleToStderrPatch } from "./stdio-s
 export function installBootstrapStdioSafety(options) {
     const restoreConsole = installConsoleToStderrPatch({
         writeToStderr: options.writeToStderr,
+        methods: options.runMode === "mcp" ? ["warn", "error"] : undefined,
     });
     let restoreStdout = () => { };
     if (options.guardMode !== "off") {

package/dist/server/stdio-safety.d.ts

@@ -1,6 +1,8 @@
 export type StdoutGuardMode = "drop" | "redirect";
+type ConsoleMethodName = "log" | "info" | "warn" | "error" | "debug";
 interface ConsolePatchOptions {
     writeToStderr?: (text: string) => void;
+    methods?: ConsoleMethodName[];
 }
 interface CliStdoutRedirectOptions {
     mode?: StdoutGuardMode;

package/dist/server/stdio-safety.js

@@ -37,6 +37,7 @@ export function installConsoleToStderrPatch(options = {}) {
     const writeToStderr = options.writeToStderr || ((text) => {
         process.stderr.write(text);
     });
+    const methods = options.methods || ["log", "info", "warn", "error", "debug"];
     const original = {};
     const patchMethod = (method) => {
         original[method] = console[method];
@@ -44,11 +45,9 @@ export function installConsoleToStderrPatch(options = {}) {
             writeToStderr(ensureTrailingNewline(args.map(toLogString).join(" ")));
         };
     };
-    patchMethod("log");
-    patchMethod("info");
-    patchMethod("warn");
-    patchMethod("error");
-    patchMethod("debug");
+    for (const method of methods) {
+        patchMethod(method);
+    }
     return () => {
         for (const method of Object.keys(original)) {
             const fn = original[method];
@@ -72,10 +71,11 @@ export function installCliStdoutRedirect(options = {}) {
                 writeToStderr(ensureTrailingNewline(`[STDOUT_BLOCKED] ${text}`));
                 return;
             }
-            writeToStderr(ensureTrailingNewline(`[STDOUT_BLOCKED] dropped len=${text.length}`));
             return;
         }
-        writeToStderr(ensureTrailingNewline(`[STDOUT_BLOCKED_BINARY len=${chunkLength(chunk)}]`));
+        if (mode === "redirect") {
+            writeToStderr(ensureTrailingNewline(`[STDOUT_BLOCKED_BINARY len=${chunkLength(chunk)}]`));
+        }
     };
     const patch = (methodName, replacement) => {
         const original = stdout[methodName];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zokizuan/satori-mcp",
-  "version": "4.11.1",
+  "version": "4.11.2",
   "description": "MCP server for Satori with agent-safe semantic search and indexing",
   "type": "module",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "jsonc-parser": "^3.3.1",
     "zod": "^3.25.55",
     "zod-to-json-schema": "^3.25.1",
-    "@zokizuan/satori-core": "1.6.1"
+    "@zokizuan/satori-core": "1.6.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",