kiri-mcp-server 0.4.1 → 0.6.0

package/dist/server/handlers.js

@@ -4,14 +4,14 @@ import { encode as encodeGPT } from "../shared/tokenizer.js";
 import { coerceProfileName, loadScoringProfile } from "./scoring.js";
 const DEFAULT_SEARCH_LIMIT = 50;
 const DEFAULT_SNIPPET_WINDOW = 150;
-const DEFAULT_BUNDLE_LIMIT = 12;
+const DEFAULT_BUNDLE_LIMIT = 7; // Reduced from 12 to optimize token usage
 const MAX_BUNDLE_LIMIT = 20;
 const MAX_KEYWORDS = 12;
 const MAX_MATCHES_PER_KEYWORD = 40;
 const MAX_DEPENDENCY_SEEDS = 8;
 const MAX_DEPENDENCY_SEEDS_QUERY_LIMIT = 100; // SQL injection防御用の上限
 const NEARBY_LIMIT = 6;
-const FALLBACK_SNIPPET_WINDOW = 120;
+const FALLBACK_SNIPPET_WINDOW = 40; // Reduced from 120 to optimize token usage
 const MAX_RERANK_LIMIT = 50;
 const STOP_WORDS = new Set([
     "the",
@@ -73,22 +73,119 @@ function normalizeBundleLimit(limit) {
     }
     return Math.min(Math.max(1, Math.floor(limit)), MAX_BUNDLE_LIMIT);
 }
-function extractKeywords(text) {
+/**
+ * トークン化戦略を取得
+ * 環境変数またはデフォルト値から決定
+ */
+function getTokenizationStrategy() {
+    const strategy = process.env.KIRI_TOKENIZATION_STRATEGY?.toLowerCase();
+    if (strategy === "legacy" || strategy === "hybrid") {
+        return strategy;
+    }
+    return "phrase-aware"; // デフォルト
+}
+/**
+ * 引用符で囲まれたフレーズを抽出
+ * 例: 'search "page-agent handler" test' → ["page-agent handler"]
+ */
+function extractQuotedPhrases(text) {
+    const phrases = [];
+    const quotePattern = /"([^"]+)"|'([^']+)'/g;
+    let match;
+    let remaining = text;
+    // eslint-disable-next-line no-cond-assign
+    while ((match = quotePattern.exec(text)) !== null) {
+        const phrase = (match[1] || match[2] || "").trim().toLowerCase();
+        if (phrase.length >= 3) {
+            phrases.push(phrase);
+        }
+        remaining = remaining.replace(match[0], " ");
+    }
+    return { phrases, remaining };
+}
+/**
+ * ハイフン区切り用語を抽出
+ * 例: "page-agent lambda-handler" → ["page-agent", "lambda-handler"]
+ */
+function extractHyphenatedTerms(text) {
+    // マッチ条件: 英数字 + ハイフン + 英数字（少なくとも3文字以上）
+    const hyphenPattern = /\b[a-z0-9]+(?:-[a-z0-9]+)+\b/gi;
+    const matches = text.match(hyphenPattern) || [];
+    return matches
+        .map((term) => term.toLowerCase())
+        .filter((term) => term.length >= 3 && !STOP_WORDS.has(term));
+}
+/**
+ * パスライクな用語を抽出
+ * 例: "lambda/page-agent/handler" → ["lambda", "page-agent", "handler"]
+ */
+function extractPathSegments(text) {
+    const pathPattern = /\b[a-z0-9_-]+(?:\/[a-z0-9_-]+)+\b/gi;
+    const matches = text.match(pathPattern) || [];
+    const segments = [];
+    for (const path of matches) {
+        const parts = path.toLowerCase().split("/");
+        for (const part of parts) {
+            if (part.length >= 3 && !STOP_WORDS.has(part) && !segments.includes(part)) {
+                segments.push(part);
+            }
+        }
+    }
+    return segments;
+}
+/**
+ * 通常の単語を抽出（レガシーロジック）
+ */
+function extractRegularWords(text, strategy) {
+    const splitPattern = strategy === "legacy" ? /[^a-z0-9_]+/iu : /[^a-z0-9_-]+/iu;
     const words = text
         .toLowerCase()
-        .split(/[^a-z0-9_]+/iu)
+        .split(splitPattern)
         .map((word) => word.trim())
         .filter((word) => word.length >= 3 && !STOP_WORDS.has(word));
-    const unique = [];
-    for (const word of words) {
-        if (!unique.includes(word)) {
-            unique.push(word);
-            if (unique.length >= MAX_KEYWORDS) {
+    return words;
+}
+/**
+ * テキストからキーワード、フレーズ、パスセグメントを抽出
+ * トークン化戦略に基づいて、ハイフン区切り用語の処理方法を変更
+ */
+function extractKeywords(text) {
+    const strategy = getTokenizationStrategy();
+    const result = {
+        phrases: [],
+        keywords: [],
+        pathSegments: [],
+    };
+    // Phase 1: 引用符で囲まれたフレーズを抽出
+    const { phrases: quotedPhrases, remaining: afterQuotes } = extractQuotedPhrases(text);
+    result.phrases.push(...quotedPhrases);
+    // Phase 2: パスセグメントを抽出
+    const pathSegments = extractPathSegments(afterQuotes);
+    result.pathSegments.push(...pathSegments);
+    // Phase 3: ハイフン区切り用語を抽出（phrase-aware または hybrid モード）
+    if (strategy === "phrase-aware" || strategy === "hybrid") {
+        const hyphenatedTerms = extractHyphenatedTerms(afterQuotes);
+        result.phrases.push(...hyphenatedTerms);
+        // hybrid モードの場合、ハイフン区切り用語を分割したキーワードも追加
+        if (strategy === "hybrid") {
+            for (const term of hyphenatedTerms) {
+                const parts = term.split("-").filter((part) => part.length >= 3 && !STOP_WORDS.has(part));
+                result.keywords.push(...parts);
+            }
+        }
+    }
+    // Phase 4: 通常の単語を抽出
+    const regularWords = extractRegularWords(afterQuotes, strategy);
+    // 重複を除去しながら、最大キーワード数まで追加
+    for (const word of regularWords) {
+        if (!result.keywords.includes(word) && !result.phrases.includes(word)) {
+            result.keywords.push(word);
+            if (result.keywords.length >= MAX_KEYWORDS) {
                 break;
             }
         }
     }
-    return unique;
+    return result;
 }
 function ensureCandidate(map, filePath) {
     let candidate = map.get(filePath);
@@ -216,10 +313,10 @@ function buildSnippetPreview(content, startLine, endLine) {
     const startIndex = Math.max(0, Math.min(startLine - 1, lines.length));
     const endIndex = Math.max(startIndex, Math.min(endLine, lines.length));
     const snippet = lines.slice(startIndex, endIndex).join("\n");
-    if (snippet.length <= 480) {
+    if (snippet.length <= 240) {
         return snippet;
     }
-    return `${snippet.slice(0, 479)}…`;
+    return `${snippet.slice(0, 239)}…`;
 }
 /**
  * トークン数を推定（コンテンツベース）
@@ -246,53 +343,339 @@ function estimateTokensFromContent(content, startLine, endLine) {
         return Math.max(1, Math.ceil(text.length / 4));
     }
 }
+/**
+ * 複数単語クエリを単語分割してOR検索条件を構築
+ * @param query - 検索クエリ文字列
+ * @returns 単語配列（2文字以下を除外）
+ */
+function splitQueryWords(query) {
+    // 空白、スラッシュ、ハイフン、アンダースコアで分割
+    const words = query.split(/[\s/\-_]+/).filter((w) => w.length > 2);
+    return words.length > 0 ? words : [query]; // 全て除外された場合は元のクエリを使用
+}
+/**
+ * ファイルタイプに基づいてスコアをブーストする
+ * プロファイルに応じて実装ファイルまたはドキュメントを優遇
+ * @param path - ファイルパス
+ * @param baseScore - 元のスコア
+ * @param profile - ブーストプロファイル ("default" | "docs" | "none")
+ * @returns ブースト適用後のスコア
+ */
+function applyFileTypeBoost(path, baseScore, profile = "default") {
+    // Blacklisted directories that are almost always irrelevant for code context
+    const blacklistedDirs = [
+        ".cursor/",
+        ".devcontainer/",
+        ".serena/",
+        "__mocks__/",
+        "docs/",
+        ".git/",
+        "node_modules/",
+    ];
+    if (blacklistedDirs.some((dir) => path.startsWith(dir))) {
+        return -100; // Effectively remove it
+    }
+    if (profile === "none") {
+        return baseScore;
+    }
+    if (profile === "docs") {
+        if (path.endsWith(".md") || path.endsWith(".yaml") || path.endsWith(".yml")) {
+            return baseScore * 1.8; // Stronger boost for docs
+        }
+        if (path.startsWith("src/") &&
+            (path.endsWith(".ts") || path.endsWith(".js") || path.endsWith(".tsx"))) {
+            return baseScore * 0.5; // Stronger penalty for implementation files
+        }
+        return baseScore;
+    }
+    // Default profile: prioritize implementation files, heavily penalize docs
+    const docExtensions = [".md", ".yaml", ".yml", ".mdc", ".json"];
+    if (docExtensions.some((ext) => path.endsWith(ext))) {
+        return baseScore * 0.1; // Heavy penalty for docs
+    }
+    if (path.startsWith("src/app/")) {
+        return baseScore * 1.8;
+    }
+    if (path.startsWith("src/components/")) {
+        return baseScore * 1.7;
+    }
+    if (path.startsWith("src/lib/")) {
+        return baseScore * 1.6;
+    }
+    if (path.startsWith("src/") &&
+        (path.endsWith(".ts") || path.endsWith(".js") || path.endsWith(".tsx"))) {
+        return baseScore * 1.5;
+    }
+    if (path.startsWith("tests/") || path.startsWith("test/")) {
+        return baseScore * 0.2; // Also penalize tests in default mode
+    }
+    return baseScore;
+}
+/**
+ * contextBundle専用のブーストプロファイル適用
+ * candidateのスコアと理由を直接変更する
+ * @param candidate - スコアリング対象の候補
+ * @param row - ファイル情報（path, ext）
+ * @param profile - ブーストプロファイル
+ */
+function applyBoostProfile(candidate, row, profile, extractedTerms, pathMatchWeight) {
+    if (profile === "none") {
+        return;
+    }
+    const { path, ext } = row;
+    const lowerPath = path.toLowerCase();
+    const fileName = path.split("/").pop() ?? "";
+    // パスベースのスコアリング: goalのキーワード/フレーズがファイルパスに含まれる場合にブースト
+    if (extractedTerms && pathMatchWeight && pathMatchWeight > 0) {
+        // フレーズがパスに完全一致する場合（最高の重み）
+        for (const phrase of extractedTerms.phrases) {
+            if (lowerPath.includes(phrase)) {
+                candidate.score += pathMatchWeight * 1.5; // 1.5倍のブースト
+                candidate.reasons.add(`path-phrase:${phrase}`);
+                break; // 最初のマッチのみ適用
+            }
+        }
+        // パスセグメントがマッチする場合（中程度の重み）
+        const pathParts = lowerPath.split("/");
+        for (const segment of extractedTerms.pathSegments) {
+            if (pathParts.includes(segment)) {
+                candidate.score += pathMatchWeight;
+                candidate.reasons.add(`path-segment:${segment}`);
+                break; // 最初のマッチのみ適用
+            }
+        }
+        // 通常のキーワードがパスに含まれる場合（低い重み）
+        for (const keyword of extractedTerms.keywords) {
+            if (lowerPath.includes(keyword)) {
+                candidate.score += pathMatchWeight * 0.5; // 0.5倍のブースト
+                candidate.reasons.add(`path-keyword:${keyword}`);
+                break; // 最初のマッチのみ適用
+            }
+        }
+    }
+    // Blacklisted directories that are almost always irrelevant for code context
+    const blacklistedDirs = [
+        ".cursor/",
+        ".devcontainer/",
+        ".serena/",
+        "__mocks__/",
+        "docs/",
+        "test/",
+        "tests/",
+        ".git/",
+        "node_modules/",
+        "db/migrate/",
+        "db/migrations/",
+        "config/",
+        "dist/",
+        "build/",
+        "out/",
+        "coverage/",
+        ".vscode/",
+        ".idea/",
+        "tmp/",
+        "temp/",
+    ];
+    if (blacklistedDirs.some((dir) => path.startsWith(dir))) {
+        candidate.score = -100; // Effectively remove it
+        candidate.reasons.add("penalty:blacklisted-dir");
+        return;
+    }
+    // Penalize test files explicitly (even if outside test directories)
+    const testPatterns = [".spec.ts", ".spec.js", ".test.ts", ".test.js", ".spec.tsx", ".test.tsx"];
+    if (testPatterns.some((pattern) => lowerPath.endsWith(pattern))) {
+        candidate.score -= 2.0; // Strong penalty for test files
+        candidate.reasons.add("penalty:test-file");
+        return;
+    }
+    // Penalize lock files and package manifests
+    const lockFiles = [
+        "package-lock.json",
+        "pnpm-lock.yaml",
+        "yarn.lock",
+        "bun.lockb",
+        "Gemfile.lock",
+        "Cargo.lock",
+        "poetry.lock",
+    ];
+    if (lockFiles.some((lockFile) => fileName === lockFile)) {
+        candidate.score -= 3.0; // Very strong penalty for lock files
+        candidate.reasons.add("penalty:lock-file");
+        return;
+    }
+    // Penalize configuration files
+    const configPatterns = [
+        ".config.js",
+        ".config.ts",
+        ".config.mjs",
+        ".config.cjs",
+        "tsconfig.json",
+        "jsconfig.json",
+        "package.json",
+        ".eslintrc",
+        ".prettierrc",
+        "jest.config",
+        "vite.config",
+        "vitest.config",
+        "webpack.config",
+        "rollup.config",
+    ];
+    if (configPatterns.some((pattern) => lowerPath.endsWith(pattern) || fileName.startsWith(".env")) ||
+        fileName === "Dockerfile" ||
+        fileName === "docker-compose.yml" ||
+        fileName === "docker-compose.yaml") {
+        candidate.score -= 1.5; // Strong penalty for config files
+        candidate.reasons.add("penalty:config-file");
+        return;
+    }
+    // Penalize migration files (by path content)
+    if (lowerPath.includes("migrate") || lowerPath.includes("migration")) {
+        candidate.score -= 2.0; // Strong penalty for migrations
+        candidate.reasons.add("penalty:migration-file");
+        return;
+    }
+    if (profile === "docs") {
+        // DOCS PROFILE: Boost docs, penalize code
+        if (path.endsWith(".md") || path.endsWith(".yaml") || path.endsWith(".yml")) {
+            candidate.score += 0.8;
+            candidate.reasons.add("boost:doc-file");
+        }
+        else if (path.startsWith("src/") && (ext === ".ts" || ext === ".tsx" || ext === ".js")) {
+            candidate.score -= 0.5;
+            candidate.reasons.add("penalty:impl-file");
+        }
+    }
+    else if (profile === "default") {
+        // DEFAULT PROFILE: Penalize docs heavily, boost implementation files.
+        // Penalize documentation and other non-code files
+        const docExtensions = [".md", ".yaml", ".yml", ".mdc", ".json"];
+        if (docExtensions.some((docExt) => path.endsWith(docExt))) {
+            candidate.score -= 1.0; // Strong penalty to overcome structural similarity
+            candidate.reasons.add("penalty:doc-file");
+        }
+        // Boost implementation files, with more specific paths getting higher scores
+        if (path.startsWith("src/app/")) {
+            candidate.score += 0.8;
+            candidate.reasons.add("boost:app-file");
+        }
+        else if (path.startsWith("src/components/")) {
+            candidate.score += 0.7;
+            candidate.reasons.add("boost:component-file");
+        }
+        else if (path.startsWith("src/lib/")) {
+            candidate.score += 0.6;
+            candidate.reasons.add("boost:lib-file");
+        }
+        else if (path.startsWith("src/")) {
+            if (ext === ".ts" || ext === ".tsx" || ext === ".js") {
+                candidate.score += 0.5;
+                candidate.reasons.add("boost:impl-file");
+            }
+        }
+    }
+}
 export async function filesSearch(context, params) {
     const { db, repoId } = context;
     const { query } = params;
     if (!query || query.trim().length === 0) {
-        throw new Error("files.search requires a non-empty query. Provide a search keyword to continue.");
+        throw new Error("files_search requires a non-empty query. Provide a search keyword to continue.");
     }
     const limit = normalizeLimit(params.limit);
-    const conditions = ["f.repo_id = ?", "b.content IS NOT NULL", "b.content ILIKE '%' || ? || '%'"];
-    const values = [repoId, query];
-    if (params.lang) {
-        conditions.push("COALESCE(f.lang, '') = ?");
-        values.push(params.lang);
-    }
-    if (params.ext) {
-        conditions.push("COALESCE(f.ext, '') = ?");
-        values.push(params.ext);
-    }
-    if (params.path_prefix) {
-        conditions.push("f.path LIKE ?");
-        values.push(`${params.path_prefix}%`);
-    }
-    const sql = `
-    SELECT f.path, f.lang, f.ext, b.content
-    FROM file f
-    JOIN blob b ON b.hash = f.blob_hash
-    WHERE ${conditions.join(" AND ")}
-    ORDER BY f.path
-    LIMIT ?
-  `;
-    values.push(limit);
+    const hasFTS = context.features?.fts ?? false;
+    let sql;
+    let values;
+    if (hasFTS) {
+        // FTS拡張利用可能: fts_main_blob.match_bm25 を使用
+        const conditions = ["f.repo_id = ?"];
+        values = [repoId];
+        // 言語・拡張子フィルタ
+        if (params.lang) {
+            conditions.push("COALESCE(f.lang, '') = ?");
+            values.push(params.lang);
+        }
+        if (params.ext) {
+            conditions.push("COALESCE(f.ext, '') = ?");
+            values.push(params.ext);
+        }
+        if (params.path_prefix) {
+            conditions.push("f.path LIKE ?");
+            values.push(`${params.path_prefix}%`);
+        }
+        // FTS検索（BM25スコアリング）
+        sql = `
+      SELECT f.path, f.lang, f.ext, b.content, fts.score
+      FROM file f
+      JOIN blob b ON b.hash = f.blob_hash
+      JOIN (
+        SELECT hash, fts_main_blob.match_bm25(hash, ?) AS score
+        FROM blob
+        WHERE score IS NOT NULL
+      ) fts ON fts.hash = b.hash
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY fts.score DESC
+      LIMIT ?
+    `;
+        values.unshift(query); // FTSクエリを先頭に追加
+        values.push(limit);
+    }
+    else {
+        // FTS拡張利用不可: ILIKE検索（Phase 1の単語分割ロジック）
+        const conditions = ["f.repo_id = ?", "b.content IS NOT NULL"];
+        values = [repoId];
+        const words = splitQueryWords(query);
+        if (words.length === 1) {
+            conditions.push("b.content ILIKE '%' || ? || '%'");
+            values.push(query);
+        }
+        else {
+            const wordConditions = words.map(() => "b.content ILIKE '%' || ? || '%'");
+            conditions.push(`(${wordConditions.join(" OR ")})`);
+            values.push(...words);
+        }
+        if (params.lang) {
+            conditions.push("COALESCE(f.lang, '') = ?");
+            values.push(params.lang);
+        }
+        if (params.ext) {
+            conditions.push("COALESCE(f.ext, '') = ?");
+            values.push(params.ext);
+        }
+        if (params.path_prefix) {
+            conditions.push("f.path LIKE ?");
+            values.push(`${params.path_prefix}%`);
+        }
+        sql = `
+      SELECT f.path, f.lang, f.ext, b.content
+      FROM file f
+      JOIN blob b ON b.hash = f.blob_hash
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY f.path
+      LIMIT ?
+    `;
+        values.push(limit);
+    }
     const rows = await db.all(sql, values);
-    return rows.map((row) => {
+    const boostProfile = params.boost_profile ?? "default";
+    return rows
+        .map((row) => {
         const { preview, line } = buildPreview(row.content ?? "", query);
+        const baseScore = row.score ?? 1.0; // FTS時はBM25スコア、ILIKE時は1.0
+        const boostedScore = applyFileTypeBoost(row.path, baseScore, boostProfile);
         return {
             path: row.path,
             preview,
             matchLine: line,
             lang: row.lang,
             ext: row.ext,
-            score: 1.0,
+            score: boostedScore,
         };
-    });
+    })
+        .sort((a, b) => b.score - a.score); // スコアの高い順に再ソート
 }
 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.");
+        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
@@ -372,7 +755,7 @@ export async function contextBundle(context, params) {
     const { db, repoId } = context;
     const goal = params.goal?.trim() ?? "";
     if (goal.length === 0) {
-        throw new Error("context.bundle requires a non-empty goal. Describe your objective to receive context.");
+        throw new Error("context_bundle requires a non-empty goal. Describe your objective to receive context.");
     }
     const limit = normalizeBundleLimit(params.limit);
     const artifacts = params.artifacts ?? {};
@@ -391,18 +774,68 @@ export async function contextBundle(context, params) {
     }
     const semanticSeed = keywordSources.join(" ");
     const queryEmbedding = generateEmbedding(semanticSeed)?.values ?? null;
-    let keywords = extractKeywords(semanticSeed);
-    if (keywords.length === 0 && artifacts.editing_path) {
+    const extractedTerms = extractKeywords(semanticSeed);
+    // フォールバック: editing_pathからキーワードを抽出
+    if (extractedTerms.phrases.length === 0 &&
+        extractedTerms.keywords.length === 0 &&
+        artifacts.editing_path) {
         const pathSegments = artifacts.editing_path
             .split(/[/_.-]/)
             .map((segment) => segment.toLowerCase())
             .filter((segment) => segment.length >= 3 && !STOP_WORDS.has(segment));
-        keywords = pathSegments.slice(0, MAX_KEYWORDS);
+        extractedTerms.pathSegments.push(...pathSegments.slice(0, MAX_KEYWORDS));
     }
     const candidates = new Map();
     const stringMatchSeeds = new Set();
     const fileCache = new Map();
-    for (const keyword of keywords) {
+    // フレーズマッチング（高い重み: textMatch × 2）
+    for (const phrase of extractedTerms.phrases) {
+        const rows = await db.all(`
+        SELECT f.path, f.lang, f.ext, f.is_binary, b.content, fe.vector_json, fe.dims AS vector_dims
+        FROM file f
+        JOIN blob b ON b.hash = f.blob_hash
+        LEFT JOIN file_embedding fe
+          ON fe.repo_id = f.repo_id
+         AND fe.path = f.path
+        WHERE f.repo_id = ?
+          AND f.is_binary = FALSE
+          AND b.content ILIKE '%' || ? || '%'
+        ORDER BY f.path
+        LIMIT ?
+      `, [repoId, phrase, MAX_MATCHES_PER_KEYWORD]);
+        for (const row of rows) {
+            if (row.content === null) {
+                continue;
+            }
+            const candidate = ensureCandidate(candidates, row.path);
+            // フレーズマッチは通常の2倍のスコア
+            candidate.score += weights.textMatch * 2.0;
+            candidate.reasons.add(`phrase:${phrase}`);
+            // Apply boost profile to prioritize/penalize files based on type and location
+            const boostProfile = params.boost_profile ?? "default";
+            applyBoostProfile(candidate, row, boostProfile, extractedTerms, weights.pathMatch);
+            const { line } = buildPreview(row.content, phrase);
+            candidate.matchLine =
+                candidate.matchLine === null ? line : Math.min(candidate.matchLine, line);
+            candidate.content ?? (candidate.content = row.content);
+            candidate.lang ?? (candidate.lang = row.lang);
+            candidate.ext ?? (candidate.ext = row.ext);
+            candidate.totalLines ?? (candidate.totalLines = row.content.length === 0 ? 0 : row.content.split(/\r?\n/).length);
+            candidate.embedding ?? (candidate.embedding = parseEmbedding(row.vector_json ?? null, row.vector_dims ?? null));
+            stringMatchSeeds.add(row.path);
+            if (!fileCache.has(row.path)) {
+                fileCache.set(row.path, {
+                    content: row.content,
+                    lang: row.lang,
+                    ext: row.ext,
+                    totalLines: candidate.totalLines ?? 0,
+                    embedding: candidate.embedding,
+                });
+            }
+        }
+    }
+    // キーワードマッチング（通常の重み）
+    for (const keyword of extractedTerms.keywords) {
         const rows = await db.all(`
         SELECT f.path, f.lang, f.ext, f.is_binary, b.content, fe.vector_json, fe.dims AS vector_dims
         FROM file f
@@ -423,14 +856,17 @@ export async function contextBundle(context, params) {
             const candidate = ensureCandidate(candidates, row.path);
             candidate.score += weights.textMatch;
             candidate.reasons.add(`text:${keyword}`);
+            // Apply boost profile to prioritize/penalize files based on type and location
+            const boostProfile = params.boost_profile ?? "default";
+            applyBoostProfile(candidate, row, boostProfile, extractedTerms, weights.pathMatch);
             const { line } = buildPreview(row.content, keyword);
             candidate.matchLine =
                 candidate.matchLine === null ? line : Math.min(candidate.matchLine, line);
-            candidate.content ??= row.content;
-            candidate.lang ??= row.lang;
-            candidate.ext ??= row.ext;
-            candidate.totalLines ??= row.content.length === 0 ? 0 : row.content.split(/\r?\n/).length;
-            candidate.embedding ??= parseEmbedding(row.vector_json ?? null, row.vector_dims ?? null);
+            candidate.content ?? (candidate.content = row.content);
+            candidate.lang ?? (candidate.lang = row.lang);
+            candidate.ext ?? (candidate.ext = row.ext);
+            candidate.totalLines ?? (candidate.totalLines = row.content.length === 0 ? 0 : row.content.split(/\r?\n/).length);
+            candidate.embedding ?? (candidate.embedding = parseEmbedding(row.vector_json ?? null, row.vector_dims ?? null));
             stringMatchSeeds.add(row.path);
             if (!fileCache.has(row.path)) {
                 fileCache.set(row.path, {
@@ -447,7 +883,7 @@ export async function contextBundle(context, params) {
         const editingCandidate = ensureCandidate(candidates, artifacts.editing_path);
         editingCandidate.score += weights.editingPath;
         editingCandidate.reasons.add("artifact:editing_path");
-        editingCandidate.matchLine ??= 1;
+        editingCandidate.matchLine ?? (editingCandidate.matchLine = 1);
     }
     // SQL injection防御: ファイルパスの検証パターン
     const SAFE_PATH_PATTERN = /^[a-zA-Z0-9_.\-/]+$/;
@@ -546,6 +982,7 @@ export async function contextBundle(context, params) {
     }
     applyStructuralScores(materializedCandidates, queryEmbedding, weights.structural);
     const sortedCandidates = materializedCandidates
+        .filter((candidate) => candidate.score > 0) // Filter out candidates with negative or zero scores
         .sort((a, b) => {
         if (b.score === a.score) {
             return a.path.localeCompare(b.path);
@@ -586,19 +1023,22 @@ export async function contextBundle(context, params) {
         if (endLine < startLine) {
             endLine = startLine;
         }
-        const preview = buildSnippetPreview(candidate.content, startLine, endLine);
         const reasons = new Set(candidate.reasons);
         if (selected && selected.symbol_name) {
             reasons.add(`symbol:${selected.symbol_name}`);
         }
         const normalizedScore = maxScore > 0 ? candidate.score / maxScore : 0;
-        results.push({
+        const item = {
             path: candidate.path,
             range: [startLine, endLine],
-            preview,
             why: Array.from(reasons).sort(),
             score: Number.isFinite(normalizedScore) ? normalizedScore : 0,
-        });
+        };
+        // Add preview only if not in compact mode
+        if (!params.compact) {
+            item.preview = buildSnippetPreview(candidate.content, startLine, endLine);
+        }
+        results.push(item);
     }
     // コンテンツベースのトークン推定を使用（より正確）
     const tokensEstimate = results.reduce((acc, item) => {
@@ -615,7 +1055,7 @@ export async function contextBundle(context, params) {
 export async function semanticRerank(context, params) {
     const text = params.text?.trim() ?? "";
     if (text.length === 0) {
-        throw new Error("semantic.rerank requires non-empty text. Describe the intent to compute semantic similarity.");
+        throw new Error("semantic_rerank requires non-empty text. Describe the intent to compute semantic similarity.");
     }
     if (!Array.isArray(params.candidates) || params.candidates.length === 0) {
         return { candidates: [] };
@@ -683,11 +1123,9 @@ export async function semanticRerank(context, params) {
 export async function depsClosure(context, params) {
     const { db, repoId } = context;
     if (!params.path) {
-        throw new Error("deps.closure requires a file path. Provide a tracked source file path to continue.");
-    }
-    if (params.direction && params.direction !== "outbound") {
-        throw new Error("deps.closure currently supports only outbound direction. Use outbound.");
+        throw new Error("deps_closure requires a file path. Provide a tracked source file path to continue.");
     }
+    const direction = params.direction ?? "outbound";
     const maxDepth = params.max_depth ?? 3;
     const includePackages = params.include_packages ?? true;
     const dependencyRows = await db.all(`
@@ -695,12 +1133,23 @@ export async function depsClosure(context, params) {
       FROM dependency
       WHERE repo_id = ?
     `, [repoId]);
+    // outbound: このファイルが使用する依存関係
     const outbound = new Map();
+    // inbound: このファイルを使用しているファイル
+    const inbound = new Map();
     for (const row of dependencyRows) {
+        // outbound マップ構築
         if (!outbound.has(row.src_path)) {
             outbound.set(row.src_path, []);
         }
         outbound.get(row.src_path)?.push(row);
+        // inbound マップ構築（dst が path の場合のみ）
+        if (row.dst_kind === "path") {
+            if (!inbound.has(row.dst)) {
+                inbound.set(row.dst, []);
+            }
+            inbound.get(row.dst)?.push(row);
+        }
     }
     const queue = [{ path: params.path, depth: 0 }];
     const visitedPaths = new Set([params.path]);
@@ -726,32 +1175,52 @@ export async function depsClosure(context, params) {
         if (current.depth >= maxDepth) {
             continue;
         }
-        const edges = outbound.get(current.path) ?? [];
+        // direction に応じて使用するマップを選択
+        const edgeMap = direction === "inbound" ? inbound : outbound;
+        const edges = edgeMap.get(current.path) ?? [];
         for (const edge of edges) {
             const nextDepth = current.depth + 1;
-            if (edge.dst_kind === "path") {
+            if (direction === "inbound") {
+                // inbound: edge.src_path がこのファイルを使用している
                 recordEdge({
-                    from: current.path,
-                    to: edge.dst,
+                    from: edge.src_path,
+                    to: current.path,
                     kind: "path",
                     rel: edge.rel,
                     depth: nextDepth,
                 });
-                recordNode({ kind: "path", target: edge.dst, depth: nextDepth });
-                if (!visitedPaths.has(edge.dst)) {
-                    visitedPaths.add(edge.dst);
-                    queue.push({ path: edge.dst, depth: nextDepth });
+                recordNode({ kind: "path", target: edge.src_path, depth: nextDepth });
+                if (!visitedPaths.has(edge.src_path)) {
+                    visitedPaths.add(edge.src_path);
+                    queue.push({ path: edge.src_path, depth: nextDepth });
                 }
             }
-            else if (edge.dst_kind === "package" && includePackages) {
-                recordEdge({
-                    from: current.path,
-                    to: edge.dst,
-                    kind: "package",
-                    rel: edge.rel,
-                    depth: nextDepth,
-                });
-                recordNode({ kind: "package", target: edge.dst, depth: nextDepth });
+            else {
+                // outbound: このファイルが edge.dst を使用している
+                if (edge.dst_kind === "path") {
+                    recordEdge({
+                        from: current.path,
+                        to: edge.dst,
+                        kind: "path",
+                        rel: edge.rel,
+                        depth: nextDepth,
+                    });
+                    recordNode({ kind: "path", target: edge.dst, depth: nextDepth });
+                    if (!visitedPaths.has(edge.dst)) {
+                        visitedPaths.add(edge.dst);
+                        queue.push({ path: edge.dst, depth: nextDepth });
+                    }
+                }
+                else if (edge.dst_kind === "package" && includePackages) {
+                    recordEdge({
+                        from: current.path,
+                        to: edge.dst,
+                        kind: "package",
+                        rel: edge.rel,
+                        depth: nextDepth,
+                    });
+                    recordNode({ kind: "package", target: edge.dst, depth: nextDepth });
+                }
             }
         }
     }
@@ -773,7 +1242,7 @@ export async function depsClosure(context, params) {
     });
     return {
         root: params.path,
-        direction: "outbound",
+        direction,
         nodes,
         edges,
     };
@@ -797,4 +1266,3 @@ export async function resolveRepoId(db, repoRoot) {
         throw error;
     }
 }
-//# sourceMappingURL=handlers.js.map