kiri-mcp-server 0.10.0 → 0.12.0

package/dist/src/server/config-loader.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parse } from "yaml";
+import { z } from "zod";
+const ENV_PREFIX = "KIRI_PATH_PENALTY_";
+const penaltyCache = new Map();
+const PathPenaltySchema = z.object({
+    prefix: z.string().trim().min(1, "prefix is required"),
+    multiplier: z.number().finite().nonnegative(),
+});
+const ConfigSchema = z.object({
+    path_penalties: z.array(PathPenaltySchema).optional(),
+});
+function normalizePrefix(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        throw new Error("Path penalty prefix cannot be empty");
+    }
+    const hadTrailingSlash = /[\\/]+$/.test(trimmed);
+    const normalized = path.posix
+        .normalize(trimmed.replace(/\\/g, "/"))
+        .replace(/^([A-Za-z]:)?\//, "") // drop drive letter or leading slash
+        .replace(/^\.\//, "");
+    if (normalized === "" || normalized === ".") {
+        throw new Error(`Path penalty prefix "${raw}" resolves to an empty path`);
+    }
+    if (normalized.startsWith("../") || normalized.includes("/../")) {
+        throw new Error(`Path penalty prefix "${raw}" must not contain ".." segments`);
+    }
+    // Re-append trailing slash only when the original explicitly had it
+    return hadTrailingSlash && !normalized.endsWith("/") ? `${normalized}/` : normalized;
+}
+function sortByPrefixLength(entries) {
+    return [...entries].sort((a, b) => b.prefix.length - a.prefix.length);
+}
+function decodeEnvKey(key) {
+    const encoded = key.slice(ENV_PREFIX.length);
+    if (!encoded) {
+        throw new Error("KIRI_PATH_PENALTY_* must include a prefix segment");
+    }
+    // Spec: "/" ↔ "__" encoding
+    const decoded = encoded.replace(/__/g, "/");
+    return normalizePrefix(decoded);
+}
+function parseEnvPathPenalties(env = process.env) {
+    const entries = [];
+    for (const [key, rawValue] of Object.entries(env)) {
+        if (!key.startsWith(ENV_PREFIX) || rawValue === undefined) {
+            continue;
+        }
+        const prefix = decodeEnvKey(key);
+        const multiplier = Number.parseFloat(rawValue);
+        if (!Number.isFinite(multiplier)) {
+            throw new Error(`Invalid multiplier for ${key}: ${rawValue}`);
+        }
+        if (multiplier < 0) {
+            throw new Error(`Multiplier for ${key} must be >= 0`);
+        }
+        entries.push({ prefix, multiplier });
+    }
+    return entries;
+}
+function readYamlConfig(cwd) {
+    const candidates = [
+        path.join(cwd, ".kiri/config.yaml"),
+        path.join(cwd, ".kiri/config.yml"),
+        path.join(cwd, "config/kiri.yaml"),
+        path.join(cwd, "config/kiri.yml"),
+    ];
+    for (const candidate of candidates) {
+        if (!fs.existsSync(candidate)) {
+            continue;
+        }
+        const raw = fs.readFileSync(candidate, "utf8");
+        const parsed = parse(raw);
+        const result = ConfigSchema.safeParse(parsed);
+        if (!result.success) {
+            const details = result.error.issues.map((issue) => issue.message).join(", ");
+            throw new Error(`Invalid path penalty config in ${candidate}: ${details}`);
+        }
+        const entries = result.data.path_penalties?.map((entry) => ({
+            prefix: normalizePrefix(entry.prefix),
+            multiplier: entry.multiplier,
+        })) ?? [];
+        return entries;
+    }
+    return [];
+}
+function mergePathPenalties(priorityOrdered) {
+    const merged = new Map();
+    for (const entries of priorityOrdered) {
+        for (const entry of entries) {
+            merged.set(entry.prefix, entry);
+        }
+    }
+    return sortByPrefixLength(Array.from(merged.values()));
+}
+/**
+ * Global resolver for path penalties (Issue #106)
+ * Precedence: profile < env < YAML (last definition wins)
+ */
+export function loadPathPenalties(basePathMultipliers = [], cwd = process.cwd()) {
+    const envEntries = Object.entries(process.env)
+        .filter(([key]) => key.startsWith(ENV_PREFIX))
+        .sort(([a], [b]) => a.localeCompare(b));
+    const cacheKey = JSON.stringify({ cwd, base: basePathMultipliers, env: envEntries });
+    const cached = penaltyCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const envPenalties = parseEnvPathPenalties();
+    const yamlPenalties = readYamlConfig(cwd);
+    const merged = mergePathPenalties([basePathMultipliers, envPenalties, yamlPenalties]);
+    penaltyCache.set(cacheKey, merged);
+    return merged;
+}
+/** Test helper: merge logic without disk/env side effects */
+export function mergePathPenaltyEntries(base, env, yaml) {
+    return mergePathPenalties([base, env, yaml]);
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/src/server/config-loader.js.map

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

package/dist/src/server/config.d.ts

@@ -0,0 +1,47 @@
+import type { PathMultiplier } from "./boost-profiles.js";
+export interface ServerConfig {
+    features: {
+        suppressNonCode: boolean;
+        suppressFinalResults: boolean;
+        clampSnippets: boolean;
+        snippetWindow: number;
+    };
+    hints: {
+        enabled: boolean;
+        priority: {
+            textMultiplier: number;
+            pathMultiplier: number;
+            baseBonus: number;
+        };
+        directory: {
+            enabled: boolean;
+            limit: number;
+            maxFiles: number;
+        };
+        dependency: {
+            enabled: boolean;
+            outLimit: number;
+            inLimit: number;
+        };
+        semantic: {
+            enabled: boolean;
+            limit: number;
+            dirCandidateLimit: number;
+            threshold: number;
+        };
+        substring: {
+            enabled: boolean;
+            limit: number;
+            boost: number;
+        };
+        perHintLimit: number;
+        dbQueryLimit: number;
+    };
+    penalties: {
+        pathMissDelta: number;
+        largeFileDelta: number;
+    };
+    pathPenalties: PathMultiplier[];
+}
+export declare function loadServerConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/server/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/server/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE;QACR,eAAe,EAAE,OAAO,CAAC;QACzB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE;YACR,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,SAAS,EAAE;YACT,OAAO,EAAE,OAAO,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,UAAU,EAAE;YACV,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,iBAAiB,EAAE,MAAM,CAAC;YAC1B,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,SAAS,EAAE;YACT,OAAO,EAAE,OAAO,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,aAAa,EAAE,cAAc,EAAE,CAAC;CACjC;AAuFD,wBAAgB,gBAAgB,IAAI,YAAY,CAoF/C"}

package/dist/src/server/config.js

@@ -0,0 +1,157 @@
+import process from "node:process";
+import { loadPathPenalties } from "./config-loader.js";
+let cachedConfig = null;
+function envFlagEnabled(value, defaultEnabled) {
+    if (value === undefined) {
+        return defaultEnabled;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized !== "0" && normalized !== "false" && normalized !== "off";
+}
+function parseEnvNumber(value, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isFinite(parsed) && parsed >= 0) {
+        return parsed;
+    }
+    return fallback;
+}
+function parseEnvFloat(value, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    const parsed = Number.parseFloat(value);
+    if (Number.isFinite(parsed)) {
+        return parsed;
+    }
+    return fallback;
+}
+function validateServerConfig(config) {
+    const { features, hints, penalties } = config;
+    if (features.snippetWindow < 8) {
+        throw new Error("snippetWindow must be >= 8 to keep bundle context useful");
+    }
+    if (hints.priority.textMultiplier <= 0 || hints.priority.pathMultiplier <= 0) {
+        throw new Error("Hint priority multipliers must be positive numbers");
+    }
+    if (hints.priority.baseBonus <= 0) {
+        throw new Error("Hint priority base bonus must be positive");
+    }
+    if (hints.directory.limit < 0 || hints.directory.maxFiles < 1) {
+        throw new Error("Directory hint limits must be non-negative and maxFiles >= 1");
+    }
+    if (hints.dependency.outLimit < 0 || hints.dependency.inLimit < 0) {
+        throw new Error("Dependency hint limits must be non-negative");
+    }
+    if (hints.semantic.limit < 0 || hints.semantic.dirCandidateLimit < 1) {
+        throw new Error("Semantic hint limits must be non-negative and candidate limit >= 1");
+    }
+    if (hints.semantic.threshold <= 0 || hints.semantic.threshold > 1) {
+        throw new Error("Semantic hint threshold must be within (0, 1]");
+    }
+    if (hints.perHintLimit < 0) {
+        throw new Error("Per-hint limit must be >= 0");
+    }
+    if (hints.enabled && hints.perHintLimit < 1) {
+        throw new Error("Per-hint limit must be >= 1 when hints are enabled");
+    }
+    if (hints.dbQueryLimit < 0) {
+        throw new Error("Hint DB query budget must be >= 0");
+    }
+    if (hints.enabled && hints.dbQueryLimit < 1) {
+        throw new Error("Hint DB query budget must be >= 1 when hints are enabled");
+    }
+    if (hints.substring.limit < 0) {
+        throw new Error("Substring hint limit must be non-negative");
+    }
+    if (penalties.pathMissDelta > 0 || penalties.largeFileDelta > 0) {
+        throw new Error("Penalty deltas should be <= 0 (they reduce scores)");
+    }
+    for (const entry of config.pathPenalties) {
+        if (!entry.prefix || typeof entry.prefix !== "string") {
+            throw new Error("Path penalty prefix must be a non-empty string");
+        }
+        if (!Number.isFinite(entry.multiplier) || entry.multiplier < 0) {
+            throw new Error(`Path penalty multiplier for ${entry.prefix} must be a non-negative finite number`);
+        }
+    }
+}
+export function loadServerConfig() {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+    const suppressNonCode = envFlagEnabled(process.env.KIRI_SUPPRESS_NON_CODE, true);
+    const suppressFinalResults = envFlagEnabled(process.env.KIRI_SUPPRESS_FINAL_RESULTS, true);
+    const clampSnippets = envFlagEnabled(process.env.KIRI_CLAMP_SNIPPETS, true);
+    const snippetWindow = Math.max(8, parseEnvNumber(process.env.KIRI_SNIPPET_WINDOW, 16));
+    const directoryEnabled = envFlagEnabled(process.env.KIRI_HINT_ENABLE_DIR, false);
+    const dependencyEnabled = envFlagEnabled(process.env.KIRI_HINT_ENABLE_DEP, false);
+    const semanticEnabled = envFlagEnabled(process.env.KIRI_HINT_ENABLE_SEM, false);
+    const substringEnabled = envFlagEnabled(process.env.KIRI_HINT_ENABLE_SUBSTRING, true);
+    const hintsEnabled = directoryEnabled || dependencyEnabled || semanticEnabled;
+    const pathPenalties = loadPathPenalties();
+    const config = {
+        features: {
+            suppressNonCode,
+            suppressFinalResults,
+            clampSnippets,
+            snippetWindow,
+        },
+        hints: {
+            enabled: hintsEnabled,
+            priority: {
+                textMultiplier: parseEnvFloat(process.env.KIRI_HINT_TEXT_MULTIPLIER, 6),
+                pathMultiplier: parseEnvFloat(process.env.KIRI_HINT_PATH_MULTIPLIER, 2),
+                baseBonus: parseEnvFloat(process.env.KIRI_HINT_BASE_BONUS, 5),
+            },
+            directory: {
+                enabled: directoryEnabled,
+                limit: directoryEnabled
+                    ? Math.max(0, parseEnvNumber(process.env.KIRI_HINT_NEAR_LIMIT_DIR, 2))
+                    : 0,
+                maxFiles: Math.max(1, parseEnvNumber(process.env.KIRI_HINT_NEAR_MAX_FILES, 10)),
+            },
+            dependency: {
+                enabled: dependencyEnabled,
+                outLimit: dependencyEnabled
+                    ? Math.max(0, parseEnvNumber(process.env.KIRI_HINT_DEP_OUT_LIMIT, 1))
+                    : 0,
+                inLimit: dependencyEnabled
+                    ? Math.max(0, parseEnvNumber(process.env.KIRI_HINT_DEP_IN_LIMIT, 1))
+                    : 0,
+            },
+            semantic: {
+                enabled: semanticEnabled,
+                limit: semanticEnabled
+                    ? Math.max(0, parseEnvNumber(process.env.KIRI_HINT_SEM_LIMIT, 2))
+                    : 0,
+                dirCandidateLimit: Math.max(1, parseEnvNumber(process.env.KIRI_HINT_SEM_DIR_CANDIDATES, 20)),
+                threshold: parseEnvFloat(process.env.KIRI_HINT_SEM_THRESHOLD, 0.65),
+            },
+            substring: {
+                enabled: substringEnabled,
+                limit: substringEnabled
+                    ? Math.max(0, parseEnvNumber(process.env.KIRI_HINT_SUBSTRING_LIMIT, 3))
+                    : 0,
+                boost: parseEnvFloat(process.env.KIRI_HINT_SUBSTRING_BOOST, 3),
+            },
+            perHintLimit: hintsEnabled
+                ? Math.max(1, parseEnvNumber(process.env.KIRI_HINT_PER_HINT_LIMIT, 6))
+                : 0,
+            dbQueryLimit: hintsEnabled
+                ? Math.max(1, parseEnvNumber(process.env.KIRI_HINT_DB_QUERY_LIMIT, 12))
+                : 0,
+        },
+        penalties: {
+            pathMissDelta: parseEnvFloat(process.env.KIRI_PATH_MISS_DELTA, -0.5),
+            largeFileDelta: parseEnvFloat(process.env.KIRI_LARGE_FILE_DELTA, -0.8),
+        },
+        pathPenalties,
+    };
+    validateServerConfig(config);
+    cachedConfig = config;
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/server/config.js.map

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

package/dist/src/server/context.d.ts

@@ -1,18 +1,47 @@
 import { DuckDBClient } from "../shared/duckdb.js";
 import { WarningManager } from "./rpc.js";
+import { ServerServices } from "./services/index.js";
 export interface FtsStatusCache {
     ready: boolean;
     schemaExists: boolean;
     anyDirty: boolean;
     lastChecked: number;
 }
+export interface TableAvailability {
+    hasMetadataTables: boolean;
+    hasLinkTable: boolean;
+    hasHintLog: boolean;
+    hasHintDictionary: boolean;
+}
 export interface ServerContext {
     db: DuckDBClient;
     repoId: number;
+    services: ServerServices;
     features?: {
         fts?: boolean;
     };
     ftsStatusCache?: FtsStatusCache;
+    tableAvailability: TableAvailability;
     warningManager: WarningManager;
 }
+/**
+ * createServerContext
+ *
+ * ServerContext を生成するファクトリ関数。
+ * テストや複数のエントリポイントで共通の初期化パスを提供する。
+ *
+ * @param options - コンテキスト初期化オプション
+ * @returns 初期化された ServerContext
+ */
+export declare function createServerContext(options: {
+    db: DuckDBClient;
+    repoId: number;
+    services: ServerServices;
+    features?: {
+        fts?: boolean;
+    };
+    ftsStatusCache?: FtsStatusCache;
+    tableAvailability: TableAvailability;
+    warningManager: WarningManager;
+}): ServerContext;
 //# sourceMappingURL=context.d.ts.map

package/dist/src/server/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/server/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;IACF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;CAChC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/server/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE;QACT,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;IACF,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,cAAc,EAAE,cAAc,CAAC;CAChC,GAAG,aAAa,CAmBhB"}

package/dist/src/server/context.js

@@ -1,2 +1,27 @@
-export {};
+/**
+ * createServerContext
+ *
+ * ServerContext を生成するファクトリ関数。
+ * テストや複数のエントリポイントで共通の初期化パスを提供する。
+ *
+ * @param options - コンテキスト初期化オプション
+ * @returns 初期化された ServerContext
+ */
+export function createServerContext(options) {
+    const context = {
+        db: options.db,
+        repoId: options.repoId,
+        services: options.services,
+        tableAvailability: options.tableAvailability,
+        warningManager: options.warningManager,
+    };
+    // exactOptionalPropertyTypes: true を満たすため、undefined の場合は代入しない
+    if (options.features !== undefined) {
+        context.features = options.features;
+    }
+    if (options.ftsStatusCache !== undefined) {
+        context.ftsStatusCache = options.ftsStatusCache;
+    }
+    return context;
+}
 //# sourceMappingURL=context.js.map

package/dist/src/server/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/server/context.ts"],"names":[],"mappings":""}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/server/context.ts"],"names":[],"mappings":"AA+BA;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAQnC;IACC,MAAM,OAAO,GAAkB;QAC7B,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;IAEF,8DAA8D;IAC9D,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAClD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/server/handlers/snippets-get.d.ts

@@ -0,0 +1,36 @@
+import { ServerContext } from "../context.js";
+/**
+ * snippets_get tool のパラメータ
+ */
+export interface SnippetsGetParams {
+    path: string;
+    start_line?: number;
+    end_line?: number;
+    compact?: boolean;
+    includeLineNumbers?: boolean;
+}
+/**
+ * snippets_get tool のレスポンス
+ */
+export interface SnippetResult {
+    path: string;
+    startLine: number;
+    endLine: number;
+    content?: string;
+    totalLines: number;
+    symbolName: string | null;
+    symbolKind: string | null;
+}
+/**
+ * snippets_get MCP Tool Handler
+ *
+ * 指定されたファイルパスから、シンボル境界を考慮したコードスニペットを取得する。
+ * start_line/end_line が指定されていない場合、最適なシンボル（関数、クラスなど）を自動選択する。
+ *
+ * @param context - サーバーコンテキスト（DB、repoId等）
+ * @param params - snippets_get パラメータ
+ * @returns スニペット結果
+ * @throws Error ファイルが見つからない、バイナリファイル、コンテンツが利用不可の場合
+ */
+export declare function snippetsGet(context: ServerContext, params: SnippetsGetParams): Promise<SnippetResult>;
+//# sourceMappingURL=snippets-get.d.ts.map

package/dist/src/server/handlers/snippets-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets-get.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/snippets-get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAmDD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,aAAa,CAAC,CAmHxB"}

package/dist/src/server/handlers/snippets-get.js

@@ -0,0 +1,120 @@
+/**
+ * Constants
+ */
+const DEFAULT_SNIPPET_WINDOW = 150;
+/**
+ * 行番号をプレフィックスとして追加する（動的幅調整）
+ *
+ * @param snippet - スニペットの内容
+ * @param startLine - 開始行番号（1-indexed）
+ * @returns 行番号付きスニペット
+ */
+function prependLineNumbers(snippet, startLine) {
+    const lines = snippet.split(/\r?\n/);
+    if (lines.length === 0) {
+        return snippet;
+    }
+    // Calculate required width from the last line number (dynamic sizing)
+    const endLine = startLine + lines.length - 1;
+    const width = String(endLine).length;
+    return lines
+        .map((line, index) => `${String(startLine + index).padStart(width, " ")}→${line}`)
+        .join("\n");
+}
+/**
+ * snippets_get MCP Tool Handler
+ *
+ * 指定されたファイルパスから、シンボル境界を考慮したコードスニペットを取得する。
+ * start_line/end_line が指定されていない場合、最適なシンボル（関数、クラスなど）を自動選択する。
+ *
+ * @param context - サーバーコンテキスト（DB、repoId等）
+ * @param params - snippets_get パラメータ
+ * @returns スニペット結果
+ * @throws Error ファイルが見つからない、バイナリファイル、コンテンツが利用不可の場合
+ */
+export async function snippetsGet(context, params) {
+    const { db, repoId } = context;
+    if (!params.path) {
+        throw new Error("snippets_get requires a file path. Specify a tracked text file path to continue.");
+    }
+    const rows = await db.all(`
+      SELECT f.path, f.lang, f.ext, f.is_binary, b.content
+      FROM file f
+      JOIN blob b ON b.hash = f.blob_hash
+      WHERE f.repo_id = ? AND f.path = ?
+      LIMIT 1
+    `, [repoId, params.path]);
+    if (rows.length === 0) {
+        throw new Error(`Requested snippet file ${params.path} was not indexed. Re-run the indexer or choose another path.`);
+    }
+    const row = rows[0];
+    if (!row) {
+        throw new Error(`Requested snippet file ${params.path} was not indexed. Re-run the indexer or choose another path.`);
+    }
+    if (row.is_binary) {
+        throw new Error("Binary snippets are not supported. Choose a text file to preview its content.");
+    }
+    if (row.content === null) {
+        throw new Error(`Snippet content was NULL for ${params.path}. Re-run the indexer with --full to repopulate blob content.`);
+    }
+    const lines = row.content.split(/\r?\n/);
+    const totalLines = lines.length;
+    const snippetRows = await db.all(`
+      SELECT s.snippet_id, s.start_line, s.end_line, s.symbol_id, sym.name AS symbol_name, sym.kind AS symbol_kind
+      FROM snippet s
+      LEFT JOIN symbol sym
+        ON sym.repo_id = s.repo_id
+       AND sym.path = s.path
+       AND sym.symbol_id = s.symbol_id
+      WHERE s.repo_id = ? AND s.path = ?
+      ORDER BY s.start_line
+    `, [repoId, params.path]);
+    const requestedStart = params.start_line ?? 1;
+    const requestedEnd = params.end_line ?? Math.min(totalLines, requestedStart + DEFAULT_SNIPPET_WINDOW - 1);
+    const useSymbolSnippets = snippetRows.length > 0 && params.end_line === undefined;
+    let snippetSelection = null;
+    if (useSymbolSnippets) {
+        snippetSelection =
+            snippetRows.find((snippet) => requestedStart >= snippet.start_line && requestedStart <= snippet.end_line) ?? null;
+        if (!snippetSelection) {
+            const firstSnippet = snippetRows[0];
+            if (firstSnippet && requestedStart < firstSnippet.start_line) {
+                snippetSelection = firstSnippet;
+            }
+            else {
+                snippetSelection = snippetRows[snippetRows.length - 1] ?? null;
+            }
+        }
+    }
+    let startLine;
+    let endLine;
+    let symbolName = null;
+    let symbolKind = null;
+    if (snippetSelection) {
+        startLine = snippetSelection.start_line;
+        endLine = snippetSelection.end_line;
+        symbolName = snippetSelection.symbol_name;
+        symbolKind = snippetSelection.symbol_kind;
+    }
+    else {
+        startLine = Math.max(1, Math.min(totalLines, requestedStart));
+        endLine = Math.max(startLine, Math.min(totalLines, requestedEnd));
+    }
+    const isCompact = params.compact === true;
+    const addLineNumbers = params.includeLineNumbers === true && !isCompact;
+    let content;
+    if (!isCompact) {
+        const snippetContent = lines.slice(startLine - 1, endLine).join("\n");
+        content = addLineNumbers ? prependLineNumbers(snippetContent, startLine) : snippetContent;
+    }
+    return {
+        path: row.path,
+        startLine,
+        endLine,
+        ...(content !== undefined && { content }),
+        totalLines,
+        symbolName,
+        symbolKind,
+    };
+}
+//# sourceMappingURL=snippets-get.js.map

package/dist/src/server/handlers/snippets-get.js.map

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