kiri-mcp-server 0.12.0 → 0.14.0

package/dist/src/server/domain-terms.js

@@ -0,0 +1,203 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "yaml";
+import { z } from "zod";
+const SAFE_PATH_PATTERN = /^[a-zA-Z0-9_.\-/]+$/;
+const DEFAULT_CANDIDATE_FILES = [
+    "config/domain-terms.yml",
+    "config/domain-terms.yaml",
+    ".kiri/domain-terms.yml",
+    ".kiri/domain-terms.yaml",
+];
+const TermDefinitionSchema = z
+    .object({
+    aliases: z.array(z.string().trim().min(1)).optional(),
+    files: z.array(z.string().trim().min(1)).optional(),
+})
+    .strict();
+function normalizeTermId(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new Error("Domain term is empty → YAML内のkey/aliasesを確認してください");
+    }
+    const decamelized = trimmed.replace(/([a-z0-9])([A-Z])/g, "$1-$2");
+    const replaced = decamelized.replace(/[\s_]+/g, "-");
+    const collapsed = replaced.replace(/[^a-zA-Z0-9-]/g, "-").replace(/-+/g, "-");
+    const normalized = collapsed.replace(/^-|-$/g, "").toLowerCase();
+    if (normalized.length < 2) {
+        throw new Error(`Domain term "${raw}" is too short after normalization → 2文字以上の識別子にしてください`);
+    }
+    return normalized;
+}
+function normalizePath(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const normalized = trimmed.replace(/^\.\/?/, "").replace(/\\/g, "/");
+    if (!SAFE_PATH_PATTERN.test(normalized)) {
+        return null;
+    }
+    return normalized;
+}
+function splitTermParts(term) {
+    const parts = term
+        .split(/[-_]/)
+        .flatMap((p) => p.split(/(?=[A-Z])/)) // simple camelCase split
+        .map((p) => p.trim().toLowerCase())
+        .filter((p) => p.length >= 3);
+    return Array.from(new Set(parts));
+}
+function buildEntries(input) {
+    const entries = [];
+    for (const [category, items] of Object.entries(input)) {
+        for (const item of items) {
+            for (const [canonical, definition] of Object.entries(item)) {
+                const normalizedCanonical = normalizeTermId(canonical);
+                const schemaResult = TermDefinitionSchema.safeParse(definition);
+                if (!schemaResult.success) {
+                    const message = schemaResult.error.issues.map((issue) => issue.message).join(", ");
+                    throw new Error(`Invalid domain term definition for ${canonical}: ${message} → YAMLの形式を修正してください`);
+                }
+                const aliases = schemaResult.data.aliases ?? [];
+                const normalizedAliases = new Set();
+                normalizedAliases.add(normalizedCanonical);
+                for (const alias of aliases) {
+                    const main = normalizeTermId(alias);
+                    normalizedAliases.add(main);
+                    for (const part of splitTermParts(alias)) {
+                        normalizedAliases.add(part);
+                    }
+                }
+                // canonicalも分割パーツを追加
+                for (const part of splitTermParts(canonical)) {
+                    normalizedAliases.add(part);
+                }
+                const files = (schemaResult.data.files ?? [])
+                    .map((file) => normalizePath(file))
+                    .filter((value) => Boolean(value));
+                entries.push({
+                    canonical,
+                    normalizedCanonical,
+                    aliases,
+                    normalizedAliases: Array.from(normalizedAliases),
+                    files,
+                    category,
+                });
+            }
+        }
+    }
+    return entries;
+}
+function extractCandidateTerms(text) {
+    const matches = text.match(/[A-Za-z0-9_-]+/g) ?? [];
+    const candidates = new Set();
+    for (const token of matches) {
+        try {
+            const normalized = normalizeTermId(token);
+            candidates.add(normalized);
+        }
+        catch {
+            continue;
+        }
+    }
+    return Array.from(candidates);
+}
+export class DomainTermsDictionary {
+    lookup;
+    constructor(entries) {
+        this.lookup = new Map();
+        for (const entry of entries) {
+            this.lookup.set(entry.normalizedCanonical, entry);
+            for (const alias of entry.normalizedAliases) {
+                this.lookup.set(alias, entry);
+            }
+        }
+    }
+    expandFromText(text) {
+        const candidates = extractCandidateTerms(text);
+        return this.expandCandidates(candidates);
+    }
+    expandCandidates(candidates) {
+        const matchedEntries = new Map();
+        for (const candidate of candidates) {
+            const entry = this.lookup.get(candidate);
+            if (entry) {
+                matchedEntries.set(entry.normalizedCanonical, entry);
+            }
+        }
+        if (matchedEntries.size === 0) {
+            return { matched: [], aliases: [], fileHints: [] };
+        }
+        const aliasKeywords = new Set();
+        const fileHints = [];
+        for (const entry of matchedEntries.values()) {
+            for (const alias of entry.normalizedAliases) {
+                aliasKeywords.add(alias);
+            }
+            if (!aliasKeywords.has(entry.normalizedCanonical)) {
+                aliasKeywords.add(entry.normalizedCanonical);
+            }
+            for (const file of entry.files) {
+                if (fileHints.some((hint) => hint.path === file)) {
+                    continue;
+                }
+                fileHints.push({ path: file, source: entry.canonical });
+            }
+        }
+        return {
+            matched: Array.from(matchedEntries.keys()),
+            aliases: Array.from(aliasKeywords),
+            fileHints,
+        };
+    }
+}
+function resolveConfigPath(configPath, cwd = process.cwd()) {
+    const explicit = configPath ?? process.env.KIRI_DOMAIN_TERMS_CONFIG;
+    if (explicit) {
+        const resolved = path.isAbsolute(explicit) ? explicit : path.join(cwd, explicit);
+        if (!fs.existsSync(resolved)) {
+            throw new Error(`Domain terms config not found at ${resolved} → パスを確認するかファイルを配置してください`);
+        }
+        return resolved;
+    }
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        ...DEFAULT_CANDIDATE_FILES.map((candidate) => path.join(cwd, candidate)),
+        path.join(currentDir, "../../../config/domain-terms.yml"),
+        path.join(currentDir, "../../../config/domain-terms.yaml"),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function loadDomainTerms(options = {}) {
+    const resolvedPath = resolveConfigPath(options.configPath, options.cwd);
+    if (!resolvedPath) {
+        return new DomainTermsDictionary([]);
+    }
+    const raw = fs.readFileSync(resolvedPath, "utf8");
+    const parsed = parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("Invalid domain terms config: top-level must be a mapping → YAMLを修正してください");
+    }
+    const dictionary = {};
+    for (const [category, value] of Object.entries(parsed)) {
+        if (!Array.isArray(value)) {
+            throw new Error(`Invalid domain terms config: category "${category}" must be an array of terms → YAMLを修正してください`);
+        }
+        dictionary[category] = value.map((entry, idx) => {
+            if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+                throw new Error(`Invalid domain terms config: entry #${idx + 1} in category "${category}" must be a mapping → YAMLを修正してください`);
+            }
+            return entry;
+        });
+    }
+    const entries = buildEntries(dictionary);
+    return new DomainTermsDictionary(entries);
+}
+//# sourceMappingURL=domain-terms.js.map

package/dist/src/server/domain-terms.js.map

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

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

@@ -50,6 +50,8 @@ export interface ContextBundleParams {
     includeTokensEstimate?: boolean;
     metadata_filters?: Record<string, string | string[]>;
     requestId?: string;
+    path_prefix?: string;
+    category?: string;
 }
 export interface ContextBundleItem {
     path: string;

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

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

package/dist/src/server/handlers.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { checkFTSSchemaExists } from "../indexer/schema.js";
+import { getAdaptiveK } from "../shared/adaptive-k.js";
 import { generateEmbedding, structuralSimilarity } from "../shared/embedding.js";
 import { encode as encodeGPT, tokenizeText } from "../shared/tokenizer.js";
 import { expandAbbreviations } from "./abbreviations.js";
@@ -337,6 +338,76 @@ function bucketArtifactHints(hints) {
     }
     return buckets;
 }
+function selectDomainPathHints(hints) {
+    const selected = [];
+    for (const hint of hints) {
+        if (!SAFE_PATH_PATTERN.test(hint.path)) {
+            continue;
+        }
+        if (selected.some((entry) => entry.path === hint.path)) {
+            continue;
+        }
+        selected.push(hint);
+        if (selected.length >= DOMAIN_PATH_HINT_LIMIT) {
+            break;
+        }
+    }
+    return selected;
+}
+/**
+ * AdaptiveK用カテゴリ自動検出
+ *
+ * 優先順位:
+ * 1. params.categoryが明示的に指定されている場合はそれを使用
+ * 2. profile/artifacts/boost_profileから推論
+ *
+ * @param params - context_bundleのパラメータ
+ * @returns 検出されたカテゴリ（undefined = デフォルトK値を使用）
+ */
+function determineCategory(params) {
+    // 明示的に指定されている場合はそれを優先
+    if (params.category) {
+        return params.category;
+    }
+    const { profile, boost_profile, artifacts } = params;
+    // artifacts.failing_testsがある場合はデバッグ作業
+    if (artifacts?.failing_tests && artifacts.failing_tests.length > 0) {
+        return "debug";
+    }
+    // profileからの推論
+    if (profile === "testfail") {
+        return "testfail";
+    }
+    if (profile === "bugfix" || profile === "typeerror") {
+        return "debug";
+    }
+    if (profile === "refactor") {
+        return "api";
+    }
+    if (profile === "feature") {
+        return "feature";
+    }
+    // boost_profileからの推論
+    if (boost_profile === "docs") {
+        return "docs";
+    }
+    // artifacts.editing_pathからの推論
+    if (artifacts?.editing_path) {
+        const editingPath = artifacts.editing_path.toLowerCase();
+        // テストファイルを編集中 → debug
+        if (editingPath.includes(".test.") ||
+            editingPath.includes(".spec.") ||
+            editingPath.includes("__tests__")) {
+            return "debug";
+        }
+        // ドキュメントを編集中 → docs
+        if (editingPath.endsWith(".md") || editingPath.includes("/docs/")) {
+            return "docs";
+        }
+    }
+    // 推論できない場合はundefined（kDefaultを使用）
+    return undefined;
+}
 function isMissingTableError(error, table) {
     if (!(error instanceof Error)) {
         return false;
@@ -462,6 +533,7 @@ const CLAMP_SNIPPETS_ENABLED = serverConfig.features.clampSnippets;
 const FALLBACK_SNIPPET_WINDOW = serverConfig.features.snippetWindow;
 const MAX_RERANK_LIMIT = 50;
 const MAX_ARTIFACT_HINTS = 8;
+const DOMAIN_PATH_HINT_LIMIT = MAX_ARTIFACT_HINTS;
 const SAFE_PATH_PATTERN = /^[a-zA-Z0-9_.\-/]+$/;
 const HINT_PRIORITY_TEXT_MULTIPLIER = serverConfig.hints.priority.textMultiplier;
 const HINT_PRIORITY_PATH_MULTIPLIER = serverConfig.hints.priority.pathMultiplier;
@@ -873,6 +945,25 @@ function ensureCandidate(map, filePath) {
     }
     return candidate;
 }
+function normalizePathPrefix(rawPrefix) {
+    // Normalize, strip leading slashes/dots, and ensure trailing slash for exact prefix match
+    const normalized = path.posix.normalize(rawPrefix.replace(/\\/g, "/"));
+    const stripped = normalized.replace(/^\.\//, "").replace(/^\/+/, "");
+    if (stripped === "" || stripped === ".") {
+        return "";
+    }
+    return stripped.endsWith("/") ? stripped : `${stripped}/`;
+}
+function normalizeFilePath(filePath) {
+    return path.posix.normalize(filePath.replace(/\\/g, "/")).replace(/^\/+/, "");
+}
+function pathMatchesPrefix(filePath, normalizedPrefix) {
+    if (!normalizedPrefix) {
+        return true;
+    }
+    const normalizedPath = normalizeFilePath(filePath);
+    return normalizedPath.startsWith(normalizedPrefix);
+}
 async function expandHintCandidatesForHints(params) {
     const { hintPaths, config } = params;
     if (hintPaths.length === 0 || config.perHintLimit <= 0 || config.dbQueryBudget <= 0) {
@@ -1575,13 +1666,17 @@ async function safeLinkQuery(db, tableAvailability, sql, params) {
         throw error;
     }
 }
-async function fetchMetadataOnlyCandidates(db, tableAvailability, repoId, filters, limit) {
+async function fetchMetadataOnlyCandidates(db, tableAvailability, repoId, filters, limit, pathPrefix) {
     if (!tableAvailability.hasMetadataTables || filters.length === 0 || limit <= 0) {
         return [];
     }
     const filterClauses = buildMetadataFilterConditions(filters);
     const whereClauses = ["f.repo_id = ?"];
     const params = [repoId];
+    if (pathPrefix) {
+        whereClauses.push("f.path LIKE ?");
+        params.push(`${pathPrefix}%`);
+    }
     for (const clause of filterClauses) {
         whereClauses.push(clause.sql);
         params.push(...clause.params);
@@ -1606,13 +1701,17 @@ async function fetchMetadataOnlyCandidates(db, tableAvailability, repoId, filter
         throw error;
     }
 }
-async function fetchMetadataKeywordMatches(db, tableAvailability, repoId, keywords, filters, limit, excludePaths) {
+async function fetchMetadataKeywordMatches(db, tableAvailability, repoId, keywords, filters, limit, excludePaths, pathPrefix) {
     if (!tableAvailability.hasMetadataTables || keywords.length === 0 || limit <= 0) {
         return [];
     }
     const keywordClauses = keywords.map(() => "mk.value ILIKE ?").join(" OR ");
     const params = [repoId, ...keywords.map((kw) => `%${kw}%`)];
     const whereClauses = ["mk.repo_id = ?", `(${keywordClauses})`];
+    if (pathPrefix) {
+        whereClauses.push("f.path LIKE ?");
+        params.push(`${pathPrefix}%`);
+    }
     if (excludePaths.size > 0) {
         const placeholders = Array.from(excludePaths)
             .map(() => "?")
@@ -2166,6 +2265,7 @@ export async function filesSearch(context, params) {
         cleanedQuery = cleanedQuery.trim();
         hasTextQuery = cleanedQuery.length > 0;
     }
+    const pathPrefix = params.path_prefix && params.path_prefix.length > 0 ? params.path_prefix : undefined;
     const metadataValueSeed = metadataFilters
         .flatMap((filter) => filter.values)
         .map((value) => value.trim())
@@ -2264,7 +2364,7 @@ export async function filesSearch(context, params) {
         candidateRows.push(...textRows);
     }
     if (!hasTextQuery && hasAnyMetadataFilters) {
-        const metadataOnlyRows = await fetchMetadataOnlyCandidates(db, context.tableAvailability, repoId, metadataFilters, limit * 2);
+        const metadataOnlyRows = await fetchMetadataOnlyCandidates(db, context.tableAvailability, repoId, metadataFilters, limit * 2, pathPrefix);
         for (const row of metadataOnlyRows) {
             row.score = 1 + metadataFilters.length * 0.2;
         }
@@ -2274,7 +2374,7 @@ export async function filesSearch(context, params) {
         const metadataKeywords = splitQueryWords(cleanedQuery.toLowerCase()).map((kw) => kw.toLowerCase());
         if (metadataKeywords.length > 0) {
             const excludePaths = new Set(candidateRows.map((row) => row.path));
-            const metadataRows = await fetchMetadataKeywordMatches(db, context.tableAvailability, repoId, metadataKeywords, metadataFilters, limit * 2, excludePaths);
+            const metadataRows = await fetchMetadataKeywordMatches(db, context.tableAvailability, repoId, metadataKeywords, metadataFilters, limit * 2, excludePaths, pathPrefix);
             candidateRows.push(...metadataRows);
         }
     }
@@ -2647,7 +2747,30 @@ async function contextBundleImpl(context, params) {
             mergedFilters: metadataFilters,
         }));
     }
-    const limit = normalizeBundleLimit(params.limit);
+    // AdaptiveK: カテゴリに基づいてK値を動的に調整
+    // 1. params.categoryが明示的に指定されていればそれを使用
+    // 2. そうでなければprofile/artifacts/boost_profileから自動検出
+    const detectedCategory = determineCategory(params);
+    const adaptiveK = getAdaptiveK(detectedCategory, serverConfig.adaptiveK);
+    if (process.env.KIRI_TRACE_ADAPTIVE_K === "1") {
+        console.info("[adaptive-k]", JSON.stringify({
+            detectedCategory,
+            selectedK: adaptiveK,
+            userLimit: params.limit ?? null,
+            enabled: serverConfig.adaptiveK.enabled,
+        }));
+    }
+    const adaptiveLimit = normalizeBundleLimit(adaptiveK);
+    const requestedLimit = normalizeBundleLimit(params.limit);
+    // AdaptiveKが無効な場合はrequestLimitをそのまま使用
+    // AdaptiveKが有効な場合:
+    //   - ユーザー指定limitがなければadaptiveKを使用
+    //   - ユーザー指定がある場合は小さい方を採用（過剰取得防止）
+    const limit = serverConfig.adaptiveK.enabled
+        ? params.limit === undefined
+            ? adaptiveLimit
+            : Math.min(requestedLimit, adaptiveLimit)
+        : requestedLimit;
     const artifacts = params.artifacts ?? {};
     const artifactHints = normalizeArtifactHints(artifacts.hints);
     const hintBuckets = bucketArtifactHints(artifactHints);
@@ -2655,6 +2778,9 @@ async function contextBundleImpl(context, params) {
     const substringHints = hintBuckets.substringHints;
     const includeTokensEstimate = params.includeTokensEstimate === true;
     const isCompact = params.compact === true;
+    const pathPrefix = params.path_prefix && params.path_prefix.length > 0
+        ? normalizePathPrefix(params.path_prefix)
+        : undefined;
     // 項目2: トークンバジェット保護警告
     // 大量データ+非コンパクトモード+トークン推定なしの場合に警告
     // リクエストごとに警告（warnForRequestを使用）
@@ -2684,6 +2810,13 @@ async function contextBundleImpl(context, params) {
             .join(" ");
         keywordSources.push(filterSeed);
     }
+    const baseSeed = keywordSources.join(" ");
+    const domainExpansion = process.env.KIRI_ENABLE_DOMAIN_TERMS === "1"
+        ? context.services.domainTerms.expandFromText(baseSeed)
+        : { matched: [], aliases: [], fileHints: [] };
+    if (domainExpansion.aliases.length > 0) {
+        keywordSources.push(domainExpansion.aliases.join(" "));
+    }
     const semanticSeed = keywordSources.join(" ");
     const queryEmbedding = generateEmbedding(semanticSeed)?.values ?? null;
     const extractedTerms = extractKeywords(semanticSeed);
@@ -2717,6 +2850,12 @@ async function contextBundleImpl(context, params) {
             .join(" OR ");
         // DEBUG: Log SQL query parameters for troubleshooting
         traceSearch(`Executing phrase match query with repo_id=${repoId}, phrases=${JSON.stringify(extractedTerms.phrases)}`);
+        const phraseWhereClauses = ["f.repo_id = ?", "f.is_binary = FALSE", `(${phrasePlaceholders})`];
+        const phraseParams = [repoId, ...extractedTerms.phrases];
+        if (pathPrefix) {
+            phraseWhereClauses.push("f.path LIKE ?");
+            phraseParams.push(`${pathPrefix}%`);
+        }
         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
@@ -2724,12 +2863,11 @@ async function contextBundleImpl(context, params) {
         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 (${phrasePlaceholders})
+        WHERE ${phraseWhereClauses.join(`
+          AND `)}
         ORDER BY f.path
         LIMIT ?
-      `, [repoId, ...extractedTerms.phrases, MAX_MATCHES_PER_KEYWORD * extractedTerms.phrases.length]);
+      `, [...phraseParams, MAX_MATCHES_PER_KEYWORD * extractedTerms.phrases.length]);
         // DEBUG: Log returned paths and verify they match expected repo_id
         if (rows.length > 0) {
             traceSearch(`Phrase match returned ${rows.length} rows. Sample paths: ${rows
@@ -2790,6 +2928,16 @@ async function contextBundleImpl(context, params) {
         const keywordPlaceholders = extractedTerms.keywords
             .map(() => "b.content ILIKE '%' || ? || '%'")
             .join(" OR ");
+        const keywordWhereClauses = [
+            "f.repo_id = ?",
+            "f.is_binary = FALSE",
+            `(${keywordPlaceholders})`,
+        ];
+        const keywordParams = [repoId, ...extractedTerms.keywords];
+        if (pathPrefix) {
+            keywordWhereClauses.push("f.path LIKE ?");
+            keywordParams.push(`${pathPrefix}%`);
+        }
         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
@@ -2797,12 +2945,11 @@ async function contextBundleImpl(context, params) {
         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 (${keywordPlaceholders})
+        WHERE ${keywordWhereClauses.join(`
+          AND `)}
         ORDER BY f.path
         LIMIT ?
-      `, [repoId, ...extractedTerms.keywords, MAX_MATCHES_PER_KEYWORD * extractedTerms.keywords.length]);
+      `, [...keywordParams, MAX_MATCHES_PER_KEYWORD * extractedTerms.keywords.length]);
         for (const row of rows) {
             if (row.content === null) {
                 continue;
@@ -2943,9 +3090,15 @@ async function contextBundleImpl(context, params) {
         sourceHint: hintPath,
         origin: "artifact",
     }));
+    const domainPathTargets = selectDomainPathHints(domainExpansion.fileHints).map((hint) => ({
+        path: hint.path,
+        sourceHint: hint.source,
+        origin: "dictionary",
+    }));
     const dictionaryPathTargets = await fetchDictionaryPathHints(db, context.tableAvailability, repoId, substringHints, HINT_DICTIONARY_LIMIT);
     const { list: resolvedPathHintTargets, meta: hintSeedMeta } = createHintSeedMeta([
         ...artifactPathTargets,
+        ...domainPathTargets,
         ...dictionaryPathTargets,
     ]);
     if (resolvedPathHintTargets.length > 0) {
@@ -3040,6 +3193,9 @@ async function contextBundleImpl(context, params) {
     const materializeCandidates = async () => {
         const result = [];
         for (const candidate of candidates.values()) {
+            if (!pathMatchesPrefix(candidate.path, pathPrefix)) {
+                continue;
+            }
             if (isSuppressedPath(candidate.path)) {
                 continue;
             }
@@ -3073,7 +3229,7 @@ async function contextBundleImpl(context, params) {
         if (!hasAnyMetadataFilters) {
             return;
         }
-        const metadataRows = await fetchMetadataOnlyCandidates(db, context.tableAvailability, repoId, metadataFilters, limit * 2);
+        const metadataRows = await fetchMetadataOnlyCandidates(db, context.tableAvailability, repoId, metadataFilters, limit * 2, pathPrefix);
         if (metadataRows.length === 0) {
             return;
         }