@zokizuan/satori-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ham-zax
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,215 @@
+# @zokizuan/satori-mcp
+
+MCP server for Satori.
+Satori means "sudden insight"; this package turns core indexing/search into agent-safe MCP actions.
+
+Maintained by: `ham-zax` (`@zokizuan`).
+
+## Breaking Change (v1.0.0)
+
+Tool surface is now hard-broken to 4 tools only:
+
+- `manage_index`
+- `search_codebase`
+- `read_file`
+- `list_codebases`
+
+Removed tools from pre-1.0 releases are no longer routed.
+
+## Features
+
+- Capability-driven execution via `CapabilityResolver`.
+- Unified `search_codebase` flow with optional reranker override:
+  - `useReranker=true`: force rerank (errors if capability missing)
+  - `useReranker=false`: disable rerank
+  - `useReranker` omitted: auto behavior by capability/profile
+- Snapshot `v3` safety with index fingerprints and strict `requires_reindex` access gates.
+- Deterministic train-in-the-error responses for incompatible or legacy index states.
+- Query-time exclusion support with `.gitignore`-style matching.
+- Structured search telemetry logs (`[TELEMETRY]` JSON to `stderr`).
+- Zod-first tool schemas converted to MCP JSON Schema for `ListTools`.
+- Auto-generated tool docs in this README from live tool schemas.
+- `read_file` line-range retrieval with default large-file truncation guard.
+- Optional proactive sync watcher mode (debounced filesystem events).
+- Index-time AST scope breadcrumbs (TS/JS/Python) rendered in search output as `🧬 Scope`.
+- Fingerprint schema bump to `dense_v2`/`hybrid_v2` with strict reindex gate for legacy `*_v1` indexes.
+- Non-AST files (for example Markdown) remain searchable when included and not ignored; they simply omit `🧬 Scope`.
+
+## Architecture Evolution
+
+### Before (pre-v1.0.0)
+
+- Monolithic routing and execution concentrated in `index.ts` + `handlers.ts`.
+- Redundant tool surface (9 tools) increased agent/tool-selection ambiguity.
+- Inline JSON schemas and docs drift risk.
+- Environment checks leaked across runtime paths.
+- Snapshot state lacked robust fingerprint protection for model/provider changes.
+
+### After (v1.0.0+)
+
+- Lightweight bootstrap in `index.ts` with registry-based tool routing.
+- Hard-break 4-tool surface optimized for agent cognition.
+- Modular tool execution in `src/tools/*.ts` with a shared `ToolContext`.
+- Zod schemas as canonical source, converted to JSON Schema at runtime.
+- Snapshot `v3` + fingerprint compatibility gates for safe multi-provider usage.
+- Deterministic train-in-the-error messages for self-healing agent loops.
+- Search observability via structured telemetry.
+- `read_file` upgraded for context-density control (ranges + truncation guard).
+
+### Architectural Shape (Current)
+
+```text
+[MCP Client]
+    -> [index.ts bootstrap + ListTools/CallTool]
+    -> [tool registry]
+    -> [manage_index | search_codebase | read_file | list_codebases]
+    -> [ToolContext DI]
+       -> [CapabilityResolver]
+       -> [SnapshotManager v3 + access gate]
+       -> [Context / Vector store / Embedding / Reranker adapters]
+```
+
+## Phase Summary
+
+- Phase 1 (state safety + API hard break):
+  - 9 tools -> 4 tools
+  - capability-driven behavior
+  - snapshot `v3` with index fingerprinting and strict reindex gating
+- Phase 2 (modularization + observability):
+  - tool registry and modular `src/tools/*`
+  - Zod-first schemas and generated docs
+  - structured search telemetry
+- Phase 3 (context density):
+  - `read_file` line-range semantics
+  - safe clamping for out-of-range requests
+  - `READ_FILE_MAX_LINES` truncation and continuation hints
+- Phase 5A (advanced context density, search-first):
+  - index-time AST breadcrumbs stored in chunk metadata (`breadcrumbs`)
+  - `search_codebase` scope rendering (`🧬 Scope: outer > inner`) across standard and rerank views
+  - fingerprint schema version bump to `*_v2` requiring reindex for `*_v1` snapshots
+
+## read_file Behavior
+
+- Supports optional `start_line` and `end_line` (1-based, inclusive).
+- When no range is provided and file length exceeds `READ_FILE_MAX_LINES` (default `1000`), output is truncated and includes a continuation hint with `path` and next `start_line`.
+
+## Proactive Sync (Optional)
+
+- Enabled by default. Set `MCP_ENABLE_WATCHER=false` to disable.
+- Debounce window via `MCP_WATCH_DEBOUNCE_MS` (default `5000`).
+- Watch events reuse the same incremental sync pipeline (`reindexByChange`) and keep `manage_index(action="sync")` as explicit fallback.
+- Safety gates:
+  - watch-triggered sync only runs for `indexed`/`sync_completed` codebases.
+  - events are dropped for `indexing`, `indexfailed`, and `requires_reindex`.
+  - ignored/hidden paths are excluded to avoid watcher explosion (`node_modules`, `.git`, build artifacts, dotfiles).
+- On shutdown (`SIGINT`/`SIGTERM`), watchers are explicitly closed.
+
+## Future Plan
+
+### 1) Agent Context Density
+
+- Add optional `read_file` paging ergonomics beyond current line ranges (for very large files/workflows).
+- Explore syntax-aware snippet shaping in `search_codebase` so results preserve function/class boundaries more reliably.
+
+### 2) Proactive Sync
+
+- Introduce optional filesystem watching with debounce for near-real-time incremental indexing.
+- Keep manual `manage_index(action="sync")` as explicit fallback.
+
+### 3) Provider Expansion
+
+- Extend reranker adapters (for example, Cohere) behind the same capability model.
+- Evaluate local vector-store adapters to support fully offline deployments.
+
+### 4) Observability Productization
+
+- Expand telemetry consumption into a local stats/report workflow (latency, reranker utilization, filter/drop rates).
+- Keep CI fast with deterministic unit/in-memory tests; run provider-backed integration checks on scheduled/manual workflows.
+
+<!-- TOOLS_START -->
+
+## Tool Reference
+
+### `manage_index`
+
+Manage index lifecycle operations (create/sync/status/clear) for a codebase path.
+
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `action` | enum("create", "sync", "status", "clear") | yes |  | Required operation to run. |
+| `path` | string | yes |  | ABSOLUTE path to the target codebase. |
+| `force` | boolean | no |  | Only for action='create'. Force rebuild from scratch. |
+| `splitter` | enum("ast", "langchain") | no |  | Only for action='create'. Code splitter strategy. |
+| `customExtensions` | array<string> | no |  | Only for action='create'. Additional file extensions to include. |
+| `ignorePatterns` | array<string> | no |  | Only for action='create'. Additional ignore patterns to apply. |
+
+### `search_codebase`
+
+Unified semantic search tool. Supports optional reranking and query-time excludes. Reranker is available. If useReranker is omitted, reranking is enabled automatically for fast/standard profiles.
+
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `path` | string | yes |  | ABSOLUTE path to an indexed codebase or subdirectory. |
+| `query` | string | yes |  | Natural-language query. |
+| `limit` | integer | no | `50` | Maximum results to return. |
+| `extensionFilter` | array<string> | no | `[]` | Optional file-extension filter (e.g. ['.ts','.py']). |
+| `useIgnoreFiles` | boolean | no | `true` | Apply repo ignore files at search-time. |
+| `excludePatterns` | array<string> | no | `[]` | Optional query-time exclude patterns. |
+| `returnRaw` | boolean | no | `false` | Return machine-readable JSON results. |
+| `showScores` | boolean | no | `false` | Include similarity scores in formatted output. |
+| `useReranker` | boolean | no |  | Optional override: true=force rerank, false=disable rerank, omitted=resolver default. |
+
+### `read_file`
+
+Read file content from the local filesystem, with optional 1-based inclusive line ranges and safe truncation.
+
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `path` | string | yes |  | ABSOLUTE path to the file. |
+| `start_line` | integer | no |  | Optional start line (1-based, inclusive). |
+| `end_line` | integer | no |  | Optional end line (1-based, inclusive). |
+
+### `list_codebases`
+
+List tracked codebases and their indexing state.
+
+No parameters.
+
+
+<!-- TOOLS_END -->
+
+## Run Locally
+
+```bash
+pnpm --filter @zokizuan/satori-mcp start
+```
+
+## Example MCP Configuration
+
+```json
+{
+  "mcpServers": {
+    "satori": {
+      "command": "npx",
+      "args": ["@zokizuan/satori-mcp@latest"],
+      "env": {
+        "EMBEDDING_PROVIDER": "VoyageAI",
+        "VOYAGEAI_API_KEY": "your-api-key",
+        "MILVUS_ADDRESS": "your-milvus-endpoint",
+        "MILVUS_TOKEN": "your-milvus-token"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+pnpm --filter @zokizuan/satori-mcp build
+pnpm --filter @zokizuan/satori-mcp typecheck
+pnpm --filter @zokizuan/satori-mcp test
+pnpm --filter @zokizuan/satori-mcp docs:check
+```
+
+`build` automatically runs docs generation from tool schemas.

package/dist/config.d.ts

@@ -0,0 +1,89 @@
+export type EmbeddingProvider = 'OpenAI' | 'VoyageAI' | 'Gemini' | 'Ollama';
+export type VectorStoreProvider = 'Milvus';
+export type FingerprintSource = 'verified' | 'assumed_v2';
+export interface IndexFingerprint {
+    embeddingProvider: EmbeddingProvider;
+    embeddingModel: string;
+    embeddingDimension: number;
+    vectorStoreProvider: VectorStoreProvider;
+    schemaVersion: 'dense_v2' | 'hybrid_v2';
+}
+export interface ContextMcpConfig {
+    name: string;
+    version: string;
+    encoderProvider: EmbeddingProvider;
+    encoderModel: string;
+    encoderOutputDimension?: number;
+    openaiKey?: string;
+    openaiEndpoint?: string;
+    voyageKey?: string;
+    geminiKey?: string;
+    geminiEndpoint?: string;
+    ollamaEncoderModel?: string;
+    ollamaEndpoint?: string;
+    milvusEndpoint?: string;
+    milvusApiToken?: string;
+    rankerModel?: 'rerank-2.5' | 'rerank-2.5-lite' | 'rerank-2' | 'rerank-2-lite';
+    readFileMaxLines?: number;
+    watchSyncEnabled?: boolean;
+    watchDebounceMs?: number;
+}
+export interface CodebaseSnapshotV1 {
+    indexedCodebases: string[];
+    indexingCodebases: string[] | Record<string, number>;
+    lastUpdated: string;
+}
+interface CodebaseInfoBase {
+    lastUpdated: string;
+    indexFingerprint?: IndexFingerprint;
+    fingerprintSource?: FingerprintSource;
+    reindexReason?: 'legacy_unverified_fingerprint' | 'fingerprint_mismatch' | 'missing_fingerprint';
+}
+export interface CodebaseInfoIndexing extends CodebaseInfoBase {
+    status: 'indexing';
+    indexingPercentage: number;
+}
+export interface CodebaseInfoIndexed extends CodebaseInfoBase {
+    status: 'indexed';
+    indexedFiles: number;
+    totalChunks: number;
+    indexStatus: 'completed' | 'limit_reached';
+}
+export interface CodebaseInfoIndexFailed extends CodebaseInfoBase {
+    status: 'indexfailed';
+    errorMessage: string;
+    lastAttemptedPercentage?: number;
+}
+export interface CodebaseInfoSyncCompleted extends CodebaseInfoBase {
+    status: 'sync_completed';
+    added: number;
+    removed: number;
+    modified: number;
+    totalChanges: number;
+}
+export interface CodebaseInfoRequiresReindex extends CodebaseInfoBase {
+    status: 'requires_reindex';
+    message: string;
+}
+export type CodebaseInfo = CodebaseInfoIndexing | CodebaseInfoIndexed | CodebaseInfoIndexFailed | CodebaseInfoSyncCompleted | CodebaseInfoRequiresReindex;
+export interface CodebaseSnapshotV2 {
+    formatVersion: 'v2';
+    codebases: Record<string, Omit<CodebaseInfo, 'status'> & {
+        status: 'indexing' | 'indexed' | 'indexfailed' | 'sync_completed';
+    }>;
+    lastUpdated: string;
+}
+export interface CodebaseSnapshotV3 {
+    formatVersion: 'v3';
+    codebases: Record<string, CodebaseInfo>;
+    lastUpdated: string;
+}
+export type CodebaseSnapshot = CodebaseSnapshotV1 | CodebaseSnapshotV2 | CodebaseSnapshotV3;
+export declare function getDefaultModelForProvider(provider: string): string;
+export declare function getEmbeddingModelForProvider(provider: string): string;
+export declare function buildRuntimeIndexFingerprint(config: ContextMcpConfig, embeddingDimension: number): IndexFingerprint;
+export declare function createMcpConfig(): ContextMcpConfig;
+export declare function logConfigurationSummary(config: ContextMcpConfig): void;
+export declare function showHelpMessage(): void;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -0,0 +1,221 @@
+import { envManager } from "@zokizuan/satori-core";
+// Helper function to get default model for each provider
+export function getDefaultModelForProvider(provider) {
+    switch (provider) {
+        case 'OpenAI':
+            return 'text-embedding-3-small';
+        case 'VoyageAI':
+            return 'voyage-4-large';
+        case 'Gemini':
+            return 'gemini-embedding-001';
+        case 'Ollama':
+            return 'nomic-embed-text';
+        default:
+            return 'text-embedding-3-small';
+    }
+}
+// Helper function to get embedding model with provider-specific environment variable priority
+export function getEmbeddingModelForProvider(provider) {
+    switch (provider) {
+        case 'Ollama': {
+            // For Ollama, prioritize OLLAMA_MODEL over EMBEDDING_MODEL for backward compatibility
+            const ollamaEncoderModel = envManager.get('OLLAMA_MODEL') || envManager.get('EMBEDDING_MODEL') || getDefaultModelForProvider(provider);
+            return ollamaEncoderModel;
+        }
+        case 'OpenAI':
+        case 'VoyageAI':
+        case 'Gemini':
+        default: {
+            // For all other providers, use EMBEDDING_MODEL or default
+            const selectedModel = envManager.get('EMBEDDING_MODEL') || getDefaultModelForProvider(provider);
+            return selectedModel;
+        }
+    }
+}
+function getSchemaVersionFromEnv() {
+    const hybridModeRaw = envManager.get('HYBRID_MODE');
+    if (!hybridModeRaw) {
+        return 'hybrid_v2';
+    }
+    return hybridModeRaw.toLowerCase() === 'true' ? 'hybrid_v2' : 'dense_v2';
+}
+export function buildRuntimeIndexFingerprint(config, embeddingDimension) {
+    return {
+        embeddingProvider: config.encoderProvider,
+        embeddingModel: config.encoderModel,
+        embeddingDimension,
+        vectorStoreProvider: 'Milvus',
+        schemaVersion: getSchemaVersionFromEnv()
+    };
+}
+export function createMcpConfig() {
+    const defaultProvider = envManager.get('EMBEDDING_PROVIDER') || 'VoyageAI';
+    const defaultReadFileMaxLines = 1000;
+    const defaultWatchDebounceMs = 5000;
+    // Parse output dimension from env var
+    const outputDimensionStr = envManager.get('EMBEDDING_OUTPUT_DIMENSION');
+    let encoderOutputDimension;
+    if (outputDimensionStr) {
+        const parsed = parseInt(outputDimensionStr, 10);
+        if ([256, 512, 1024, 2048].includes(parsed)) {
+            encoderOutputDimension = parsed;
+        }
+        else {
+            console.warn(`[WARN] Invalid EMBEDDING_OUTPUT_DIMENSION value: ${outputDimensionStr}. Must be 256, 512, 1024, or 2048.`);
+        }
+    }
+    else if (defaultProvider === 'VoyageAI') {
+        // Default to 1024 for VoyageAI to balance quality/cost.
+        encoderOutputDimension = 1024;
+    }
+    // Parse reranker model from env var
+    const rankerModelEnv = envManager.get('VOYAGEAI_RERANKER_MODEL');
+    let rankerModel;
+    if (rankerModelEnv && ['rerank-2.5', 'rerank-2.5-lite', 'rerank-2', 'rerank-2-lite'].includes(rankerModelEnv)) {
+        rankerModel = rankerModelEnv;
+    }
+    else {
+        rankerModel = 'rerank-2.5';
+    }
+    let readFileMaxLines = defaultReadFileMaxLines;
+    const readFileMaxLinesRaw = envManager.get('READ_FILE_MAX_LINES');
+    if (readFileMaxLinesRaw) {
+        const parsed = Number.parseInt(readFileMaxLinesRaw, 10);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            readFileMaxLines = parsed;
+        }
+        else {
+            console.warn(`[WARN] Invalid READ_FILE_MAX_LINES value: ${readFileMaxLinesRaw}. Using default ${defaultReadFileMaxLines}.`);
+        }
+    }
+    const watchSyncEnabledRaw = envManager.get('MCP_ENABLE_WATCHER');
+    const watchSyncEnabled = watchSyncEnabledRaw
+        ? watchSyncEnabledRaw.toLowerCase() === 'true'
+        : true;
+    let watchDebounceMs = defaultWatchDebounceMs;
+    const watchDebounceRaw = envManager.get('MCP_WATCH_DEBOUNCE_MS');
+    if (watchDebounceRaw) {
+        const parsed = Number.parseInt(watchDebounceRaw, 10);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            watchDebounceMs = parsed;
+        }
+        else {
+            console.warn(`[WARN] Invalid MCP_WATCH_DEBOUNCE_MS value: ${watchDebounceRaw}. Using default ${defaultWatchDebounceMs}.`);
+        }
+    }
+    const config = {
+        name: envManager.get('MCP_SERVER_NAME') || "Satori MCP Server",
+        version: envManager.get('MCP_SERVER_VERSION') || "1.0.0",
+        // Embedding provider configuration
+        encoderProvider: defaultProvider,
+        encoderModel: getEmbeddingModelForProvider(defaultProvider),
+        encoderOutputDimension,
+        // Provider-specific API keys
+        openaiKey: envManager.get('OPENAI_API_KEY'),
+        openaiEndpoint: envManager.get('OPENAI_BASE_URL'),
+        voyageKey: envManager.get('VOYAGEAI_API_KEY'),
+        geminiKey: envManager.get('GEMINI_API_KEY'),
+        geminiEndpoint: envManager.get('GEMINI_BASE_URL'),
+        // Ollama configuration
+        ollamaEncoderModel: envManager.get('OLLAMA_MODEL'),
+        ollamaEndpoint: envManager.get('OLLAMA_HOST'),
+        // Vector database configuration - address can be auto-resolved from token
+        milvusEndpoint: envManager.get('MILVUS_ADDRESS'), // Optional, can be resolved from token
+        milvusApiToken: envManager.get('MILVUS_TOKEN'),
+        // Reranker configuration
+        rankerModel,
+        // read_file behavior
+        readFileMaxLines,
+        // proactive sync watcher behavior
+        watchSyncEnabled,
+        watchDebounceMs,
+    };
+    return config;
+}
+export function logConfigurationSummary(config) {
+    // Log configuration summary before starting server
+    console.log(`[MCP] 🚀 Starting Satori MCP Server`);
+    console.log(`[MCP] Configuration Summary:`);
+    console.log(`[MCP]   Server: ${config.name} v${config.version}`);
+    console.log(`[MCP]   Embedding Provider: ${config.encoderProvider}`);
+    console.log(`[MCP]   Embedding Model: ${config.encoderModel}`);
+    console.log(`[MCP]   Milvus Address: ${config.milvusEndpoint || (config.milvusApiToken ? '[Auto-resolve from token]' : '[Not configured]')}`);
+    console.log(`[MCP]   Proactive Watcher: ${config.watchSyncEnabled ? `enabled (${config.watchDebounceMs || 5000}ms debounce)` : 'disabled'}`);
+    // Log provider-specific configuration without exposing sensitive data
+    switch (config.encoderProvider) {
+        case 'OpenAI':
+            console.log(`[MCP]   OpenAI API Key: ${config.openaiKey ? '✅ Configured' : '❌ Missing'}`);
+            if (config.openaiEndpoint) {
+                console.log(`[MCP]   OpenAI Base URL: ${config.openaiEndpoint}`);
+            }
+            break;
+        case 'VoyageAI':
+            console.log(`[MCP]   VoyageAI API Key: ${config.voyageKey ? '✅ Configured' : '❌ Missing'}`);
+            break;
+        case 'Gemini':
+            console.log(`[MCP]   Gemini API Key: ${config.geminiKey ? '✅ Configured' : '❌ Missing'}`);
+            if (config.geminiEndpoint) {
+                console.log(`[MCP]   Gemini Base URL: ${config.geminiEndpoint}`);
+            }
+            break;
+        case 'Ollama':
+            console.log(`[MCP]   Ollama Host: ${config.ollamaEndpoint || 'http://127.0.0.1:11434'}`);
+            console.log(`[MCP]   Ollama Model: ${config.encoderModel}`);
+            break;
+    }
+    console.log(`[MCP] 🔧 Initializing server components...`);
+}
+export function showHelpMessage() {
+    console.log(`
+Satori MCP Server
+
+Usage: npx @zokizuan/satori-mcp@latest [options]
+
+Options:
+  --help, -h                          Show this help message
+
+Environment Variables:
+  MCP_SERVER_NAME         Server name
+  MCP_SERVER_VERSION      Server version
+
+  Embedding Provider Configuration:
+  EMBEDDING_PROVIDER      Embedding provider: OpenAI, VoyageAI, Gemini, Ollama (default: VoyageAI)
+  EMBEDDING_MODEL         Embedding model name (works for all providers)
+
+  Provider-specific API Keys:
+  OPENAI_API_KEY          OpenAI API key (required for OpenAI provider)
+  OPENAI_BASE_URL         OpenAI API base URL (optional, for custom endpoints)
+  VOYAGEAI_API_KEY        VoyageAI API key (required for VoyageAI provider)
+  GEMINI_API_KEY          Google AI API key (required for Gemini provider)
+  GEMINI_BASE_URL         Gemini API base URL (optional, for custom endpoints)
+
+  Ollama Configuration:
+  OLLAMA_HOST             Ollama server host (default: http://127.0.0.1:11434)
+  OLLAMA_MODEL            Ollama model name (alternative to EMBEDDING_MODEL for Ollama)
+
+  Vector Database Configuration:
+  MILVUS_ADDRESS          Milvus address (optional, can be auto-resolved from token)
+  MILVUS_TOKEN            Milvus token (optional, used for authentication and address resolution)
+
+  Read File Configuration:
+  READ_FILE_MAX_LINES     Max lines returned by read_file when no explicit range is provided (default: 1000)
+
+  Proactive Sync Configuration:
+  MCP_ENABLE_WATCHER      Enable filesystem watch mode for near-real-time sync (default: true)
+  MCP_WATCH_DEBOUNCE_MS   Debounce window for watch-triggered sync in milliseconds (default: 5000)
+
+Examples:
+  # Start MCP server with OpenAI and explicit Milvus address
+  OPENAI_API_KEY=sk-xxx MILVUS_ADDRESS=localhost:19530 npx @zokizuan/satori-mcp@latest
+
+  # Start MCP server with VoyageAI and specific model
+  EMBEDDING_PROVIDER=VoyageAI VOYAGEAI_API_KEY=pa-xxx EMBEDDING_MODEL=voyage-4-large MILVUS_TOKEN=your-token npx @zokizuan/satori-mcp@latest
+
+  # Start MCP server with Gemini and specific model
+  EMBEDDING_PROVIDER=Gemini GEMINI_API_KEY=xxx EMBEDDING_MODEL=gemini-embedding-001 MILVUS_TOKEN=your-token npx @zokizuan/satori-mcp@latest
+
+  # Start MCP server with Ollama and specific model
+  EMBEDDING_PROVIDER=Ollama EMBEDDING_MODEL=nomic-embed-text MILVUS_TOKEN=your-token npx @zokizuan/satori-mcp@latest
+        `);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/core/ast_breadcrumbs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ast_breadcrumbs.test.d.ts.map

package/dist/core/ast_breadcrumbs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast_breadcrumbs.test.d.ts","sourceRoot":"","sources":["../../src/core/ast_breadcrumbs.test.ts"],"names":[],"mappings":""}

package/dist/core/ast_breadcrumbs.test.js

@@ -0,0 +1,72 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { AstCodeSplitter } from '@zokizuan/satori-core';
+test('AstCodeSplitter emits TS class/method breadcrumbs', async () => {
+    const splitter = new AstCodeSplitter();
+    const code = [
+        'export class AuthManager {',
+        '  async validateSession(token: string) {',
+        '    return token.length > 0;',
+        '  }',
+        '}'
+    ].join('\n');
+    const chunks = await splitter.split(code, 'typescript', '/tmp/auth.ts');
+    const target = chunks.find((chunk) => chunk.content.includes('return token.length > 0;')
+        && Array.isArray(chunk.metadata.breadcrumbs)
+        && chunk.metadata.breadcrumbs.length === 2);
+    assert.ok(target);
+    assert.deepEqual(target?.metadata.breadcrumbs, ['class AuthManager', 'async method validateSession(token: string)']);
+});
+test('AstCodeSplitter emits Python class/function breadcrumbs', async () => {
+    const splitter = new AstCodeSplitter();
+    const code = [
+        'class SessionManager:',
+        '    async def validate(self, token: str):',
+        '        return token',
+        ''
+    ].join('\n');
+    const chunks = await splitter.split(code, 'python', '/tmp/auth.py');
+    const target = chunks.find((chunk) => chunk.content.includes('return token')
+        && Array.isArray(chunk.metadata.breadcrumbs)
+        && chunk.metadata.breadcrumbs.length === 2);
+    assert.ok(target);
+    assert.deepEqual(target?.metadata.breadcrumbs, ['class SessionManager', 'async function validate(self, token: str)']);
+});
+test('AstCodeSplitter caps breadcrumb depth at 2', async () => {
+    const splitter = new AstCodeSplitter();
+    const code = [
+        'class A {',
+        '  outer() {',
+        '    const inner = () => {',
+        '      return 1;',
+        '    };',
+        '    return inner();',
+        '  }',
+        '}'
+    ].join('\n');
+    const chunks = await splitter.split(code, 'typescript', '/tmp/depth.ts');
+    for (const chunk of chunks) {
+        if (Array.isArray(chunk.metadata.breadcrumbs)) {
+            assert.ok(chunk.metadata.breadcrumbs.length <= 2);
+        }
+    }
+});
+test('AstCodeSplitter preserves breadcrumbs when splitting large chunks', async () => {
+    const splitter = new AstCodeSplitter(80, 0);
+    const repeatedBody = Array.from({ length: 30 }, (_, i) => `    const v${i} = token + ${i};`).join('\n');
+    const code = [
+        'class LargeAuth {',
+        '  validate(token: string) {',
+        repeatedBody,
+        '    return token;',
+        '  }',
+        '}'
+    ].join('\n');
+    const chunks = await splitter.split(code, 'typescript', '/tmp/large.ts');
+    const methodChunks = chunks.filter((chunk) => Array.isArray(chunk.metadata.breadcrumbs) && chunk.metadata.breadcrumbs.includes('method validate(token: string)'));
+    assert.ok(methodChunks.length > 1);
+    for (const chunk of methodChunks) {
+        assert.deepEqual(chunk.metadata.breadcrumbs, ['class LargeAuth', 'method validate(token: string)']);
+    }
+});
+//# sourceMappingURL=ast_breadcrumbs.test.js.map

package/dist/core/ast_breadcrumbs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast_breadcrumbs.test.js","sourceRoot":"","sources":["../../src/core/ast_breadcrumbs.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;IACjE,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG;QACT,4BAA4B;QAC5B,0CAA0C;QAC1C,8BAA8B;QAC9B,KAAK;QACL,GAAG;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CACtB,CAAC,KAAK,EAAE,EAAE,CACN,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC;WAC/C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;WACzC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CACjD,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAClB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,mBAAmB,EAAE,6CAA6C,CAAC,CAAC,CAAC;AACzH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG;QACT,uBAAuB;QACvB,2CAA2C;QAC3C,sBAAsB;QACtB,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CACtB,CAAC,KAAK,EAAE,EAAE,CACN,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;WACnC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;WACzC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CACjD,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAClB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,sBAAsB,EAAE,2CAA2C,CAAC,CAAC,CAAC;AAC1H,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC1D,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG;QACT,WAAW;QACX,aAAa;QACb,2BAA2B;QAC3B,iBAAiB;QACjB,QAAQ;QACR,qBAAqB;QACrB,KAAK;QACL,GAAG;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;IACjF,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxG,MAAM,IAAI,GAAG;QACT,mBAAmB;QACnB,6BAA6B;QAC7B,YAAY;QACZ,mBAAmB;QACnB,KAAK;QACL,GAAG;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC,CAAC;IAClK,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,gCAAgC,CAAC,CAAC,CAAC;IACxG,CAAC;AACL,CAAC,CAAC,CAAC"}