homegraph 1.5.2 → 1.5.3

package/dist/search/query-utils.js

@@ -38,7 +38,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IMPLEMENTATION_ENTRY_NAME_RE = exports.STOP_WORDS = exports.QUERY_SOURCE_FILE_EXT = void 0;
+exports.IMPLEMENTATION_ENTRY_NAME_RE = exports.GENERIC_VERB_ANCHOR_NOISE = exports.STOP_WORDS = exports.FRAMEWORK_UI_DECORATOR_NAMES = exports.QUERY_SOURCE_FILE_EXT = void 0;
 exports.normalizeNameToken = normalizeNameToken;
 exports.extractFileBasenamesFromQuery = extractFileBasenamesFromQuery;
 exports.extractPathSegmentsFromQuery = extractPathSegmentsFromQuery;
@@ -47,11 +47,20 @@ exports.extractKitModuleNamesFromQuery = extractKitModuleNamesFromQuery;
 exports.extractKitSubmoduleNamesFromQuery = extractKitSubmoduleNamesFromQuery;
 exports.queryAsKitModuleCapabilitySurvey = queryAsKitModuleCapabilitySurvey;
 exports.isMemberLikeIdentifier = isMemberLikeIdentifier;
+exports.queryAsCoNamedTypeMethodInteraction = queryAsCoNamedTypeMethodInteraction;
 exports.queryHasNamedMemberFocus = queryHasNamedMemberFocus;
 exports.queryAsNamedComponentAction = queryAsNamedComponentAction;
 exports.queryAsOutOfRepoSdkCatalog = queryAsOutOfRepoSdkCatalog;
+exports.queryShouldDeferToBuiltinTools = queryShouldDeferToBuiltinTools;
+exports.homegraphDeferGuidance = homegraphDeferGuidance;
 exports.queryShouldPreferExploreOverSearch = queryShouldPreferExploreOverSearch;
+exports.shouldBuildHoverHandlerSurvey = shouldBuildHoverHandlerSurvey;
+exports.isFrameworkUiDecoratorName = isFrameworkUiDecoratorName;
+exports.queryLooksLikeUiComponentType = queryLooksLikeUiComponentType;
+exports.queryAsFocusedUiCluster = queryAsFocusedUiCluster;
+exports.queryAsComponentSurfaceSurvey = queryAsComponentSurfaceSurvey;
 exports.shouldBuildKitModuleUsageSurvey = shouldBuildKitModuleUsageSurvey;
+exports.queryAsksKitInstallDeps = queryAsksKitInstallDeps;
 exports.extractMemberAccessFromQuery = extractMemberAccessFromQuery;
 exports.extractImportSearchTerms = extractImportSearchTerms;
 exports.fileMatchesQueryBasename = fileMatchesQueryBasename;
@@ -62,6 +71,22 @@ exports.queryNamesConfigFile = queryNamesConfigFile;
 exports.hasSymbolFilterInQuery = hasSymbolFilterInQuery;
 exports.hasImportInventoryFilter = hasImportInventoryFilter;
 exports.queryAsApiUsageSurvey = queryAsApiUsageSurvey;
+exports.extractFieldLikeSymbolsFromQuery = extractFieldLikeSymbolsFromQuery;
+exports.queryAsDeclarationSiteSurvey = queryAsDeclarationSiteSurvey;
+exports.queryAsInRepoSystemCapabilityHowto = queryAsInRepoSystemCapabilityHowto;
+exports.queryAsReturnValueConsumerSurvey = queryAsReturnValueConsumerSurvey;
+exports.queryAsConstantUsageSurvey = queryAsConstantUsageSurvey;
+exports.queryAsFieldUsageSurvey = queryAsFieldUsageSurvey;
+exports.queryAsNativeRenderThreadSurvey = queryAsNativeRenderThreadSurvey;
+exports.queryAsDtsWrapSurvey = queryAsDtsWrapSurvey;
+exports.queryAsAssignedFlagImpactSurvey = queryAsAssignedFlagImpactSurvey;
+exports.queryAsNamedControlStateSyncSurvey = queryAsNamedControlStateSyncSurvey;
+exports.extractListedTypeMethodsFromQuery = extractListedTypeMethodsFromQuery;
+exports.queryAsModuleExportSurvey = queryAsModuleExportSurvey;
+exports.queryAsModuleDependencySurvey = queryAsModuleDependencySurvey;
+exports.queryLooksLikeLiteralOrCopyHunt = queryLooksLikeLiteralOrCopyHunt;
+exports.queryAsTypeLifecycleSurvey = queryAsTypeLifecycleSurvey;
+exports.shouldPreferMemberUsageInventory = shouldPreferMemberUsageInventory;
 exports.extractApiUsageTokens = extractApiUsageTokens;
 exports.shouldBuildApiUsageSurvey = shouldBuildApiUsageSurvey;
 exports.queryAsCallerOrMethodSurvey = queryAsCallerOrMethodSurvey;
@@ -80,6 +105,7 @@ exports.shouldFocusOnQueryNamedDefs = shouldFocusOnQueryNamedDefs;
 exports.queryAsInterpretationSurvey = queryAsInterpretationSurvey;
 exports.queryAsTestOnlyInterpretation = queryAsTestOnlyInterpretation;
 exports.extractMechanismEntrySeeds = extractMechanismEntrySeeds;
+exports.queryAsDomainMechanismBag = queryAsDomainMechanismBag;
 exports.shouldTryLightMechanismExplore = shouldTryLightMechanismExplore;
 exports.shouldTryFastInventoryExplore = shouldTryFastInventoryExplore;
 exports.shouldBuildInheritanceSurvey = shouldBuildInheritanceSurvey;
@@ -178,7 +204,9 @@ function extractKitModuleNamesFromQuery(query) {
     }
     return [...names];
 }
-/** Submodule tokens from queries like `util模块` / `util 模块`. */
+/** Submodule / named-export tokens from kit usage questions.
+ *  Covers `util模块`, `util 模块`, and `@kit.Foo的bar` / `@kit.Foo bar` (export focus).
+ */
 function extractKitSubmoduleNamesFromQuery(query) {
     const names = new Set();
     for (const m of query.matchAll(/([a-z][a-z0-9_]{1,24})模块/gi)) {
@@ -189,6 +217,15 @@ function extractKitSubmoduleNamesFromQuery(query) {
         if (m[1] && m[1].length >= 2)
             names.add(m[1]);
     }
+    // `@kit.ArkTS的taskpool` / `@kit.ArkTS的 foo` — named export, not a catalog.
+    for (const m of query.matchAll(/@kit\.[A-Za-z][A-Za-z0-9]*的\s*([a-z][a-zA-Z0-9_]{2,24})\b/gi)) {
+        if (m[1])
+            names.add(m[1]);
+    }
+    for (const m of query.matchAll(/@kit\.[A-Za-z][A-Za-z0-9]*[\s.]+([a-z][a-zA-Z0-9_]{2,24})\b/gi)) {
+        if (m[1] && !exports.STOP_WORDS.has(m[1].toLowerCase()))
+            names.add(m[1]);
+    }
     return [...names];
 }
 /**
@@ -224,6 +261,29 @@ function isMemberLikeIdentifier(token) {
     // camelCase property/method: first lower, later upper
     return /^[a-z][a-zA-Z0-9]*[A-Z]/.test(token);
 }
+/**
+ * Owning Type + co-named PascalCase methods (CanPlace/Place ↔ BinaryGrid).
+ * Not Type.member dotted form — agents name methods as sibling Types.
+ * Must stay on compact explore — 「是怎么」alone would light-mechanism dump.
+ */
+function queryAsCoNamedTypeMethodInteraction(query) {
+    // "who calls Type's Set/Test/Fill" is a caller inventory, not body interaction.
+    if (queryAsCallerOrMethodSurvey(query))
+        return false;
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    if (types.length < 2 || types.length > 4)
+        return false;
+    const owners = types.filter((t) => t.length >= 8
+        || /(?:Grid|Manager|Service|Controller|Render|Plugin|Layout|Handler|Provider|Store)/i.test(t));
+    const methods = types.filter((t) => !owners.includes(t));
+    if (owners.length < 1 || methods.length < 1)
+        return false;
+    if (/交互|是怎么|如何.*(?:用|调|连|互)|how\s+(?:do|does|are).{0,48}(?:interact|relate|use|call)|与.+交互|和.+交互/i.test(query)) {
+        return true;
+    }
+    // Method-looking PascalCase co-named with an owner — even without 交互.
+    return methods.some((m) => /^(?:Can|Is|Has|Get|Set|Place|Fill|Test|Put|Add|Remove|Update|Draw|Check|Find)/.test(m));
+}
 /**
  * Named Type + member (dot form, or co-named Type + member-like token).
  * Structural — no product/question nouns.
@@ -231,6 +291,8 @@ function isMemberLikeIdentifier(token) {
 function queryHasNamedMemberFocus(query) {
     if (extractMemberAccessFromQuery(query).length > 0)
         return true;
+    if (queryAsCoNamedTypeMethodInteraction(query))
+        return true;
     const types = extractTypeNamesFromQuery(query);
     if (types.length === 0 || types.length > 3)
         return false;
@@ -248,10 +310,10 @@ function queryAsNamedComponentAction(query) {
     if (!looksUi)
         return false;
     const deps = extractDependencySymbolsFromQuery(query);
-    if (deps.some((d) => /^on[A-Z]/.test(d) || /^(click|tap|press)$/i.test(d)))
+    if (deps.some((d) => /^on[A-Z]/.test(d) || /^(click|tap|press|hover)$/i.test(d)))
         return true;
     // Optional thin intent — only with a UI-looking Type already present.
-    return /点击|单击|按下|按钮|onClick|onTap|会发生什么|what\s+happens|when\s+(?:clicked|pressed)/i.test(query);
+    return /点击|单击|按下|按钮|悬停|hover|onClick|onTap|onHover|会发生什么|what\s+happens|when\s+(?:clicked|pressed|hovered)/i.test(query);
 }
 /**
  * Out-of-repo SDK catalog (kept for survey omit logic — not as a refuse list).
@@ -264,6 +326,97 @@ function queryAsOutOfRepoSdkCatalog(query) {
         return false;
     return /@kit\.|\b[A-Z][A-Za-z0-9]*Kit\b/i.test(query);
 }
+function queryShouldDeferToBuiltinTools(query) {
+    const q = query.trim();
+    if (!q)
+        return null;
+    // Pre-existing catalog classifiers (@kit / *Kit + "what features/APIs").
+    // Checked before named-member heuristics — `@kit.X` can look like Type.member.
+    if (queryAsOutOfRepoSdkCatalog(q) || queryAsKitModuleCapabilitySurvey(q)) {
+        return 'sdk-catalog';
+    }
+    const hasType = extractTypeNamesFromQuery(q).length > 0;
+    const hasFile = extractFileBasenamesFromQuery(q).length > 0;
+    const hasMember = extractMemberAccessFromQuery(q).length > 0;
+    const hasKit = /@kit\.|@ohos\./i.test(q);
+    const hasCaps = /\b[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+\b/.test(q);
+    const hasField = extractFieldLikeSymbolsFromQuery(q).length > 0;
+    const hasPath = extractPathSegmentsFromQuery(q).length > 0;
+    // Literal / layout / "import text from graphics package" hunts → Grep.
+    // No PascalCase Type — light-mechanism must not claim these.
+    if (!hasType
+        && !hasFile
+        && !hasMember
+        && !hasKit
+        && !hasCaps
+        && !hasField
+        && !hasPath
+        && queryLooksLikeLiteralOrCopyHunt(q)) {
+        return 'concept-or-existence';
+    }
+    // Structural / in-repo usage surveys must still run.
+    if (queryAsMechanismSurvey(q) || queryAsCrossModuleFlowSurvey(q))
+        return null;
+    if (shouldBuildKitModuleUsageSurvey(q) || shouldBuildApiUsageSurvey(q))
+        return null;
+    if (shouldBuildCallerInventory(q) || shouldTryLightMechanismExplore(q))
+        return null;
+    if (queryAsNamedComponentAction(q) || queryHasNamedMemberFocus(q))
+        return null;
+    if (queryAsInterpretationSurvey(q) || queryAsLocalSymbolDetail(q))
+        return null;
+    if (queryHasFocusedNamedAnchors(q))
+        return null;
+    if (queryAsDeclarationSiteSurvey(q)
+        || queryAsConstantUsageSurvey(q)
+        || queryAsFieldUsageSurvey(q)
+        || queryAsModuleExportSurvey(q)
+        || queryAsModuleDependencySurvey(q)) {
+        return null;
+    }
+    // "Which files relate to <topic>?" with no Type/file anchor → Glob/Grep.
+    if (/哪些文件|有哪些.*文件|相关的?\s*文件|涉及.*文件|which\s+files?|files?\s+(?:are\s+)?related/i.test(q)
+        && !hasType
+        && !hasFile) {
+        return 'file-listing';
+    }
+    // Existence / concept-compare with no graph anchor → Grep/docs.
+    if (/有使用|是否使用|有没有使用|使用了.*吗|是否存在|有没有完整|有什么不同|区别|difference|vs\.?|versus|对比|does\s+(?:this\s+)?(?:project|repo)\s+have|is\s+there\s+(?:a\s+)?complete/i.test(q)
+        && !hasType
+        && !hasFile
+        && !hasMember
+        && !hasKit) {
+        return 'concept-or-existence';
+    }
+    // Hover / 悬停 without a named Type → inventory of hover handlers (not Skip).
+    if (shouldBuildHoverHandlerSurvey(q))
+        return null;
+    // Behavioral / interaction outcome with zero graph anchors → Grep (no symbol to seed).
+    // Do NOT include hover/悬停 here — those have a graph inventory path above.
+    if (!hasType
+        && !hasFile
+        && !hasMember
+        && !hasKit
+        && /会有什么|会发生什么|什么反应|what\s+happens|what\s+(?:is|are)\s+the\s+(?:reaction|response)|when\s+(?:the\s+)?user\b/i.test(q)) {
+        return 'concept-or-existence';
+    }
+    return null;
+}
+/** Short success-shaped reply when explore/search should not run. */
+function homegraphDeferGuidance(kind, query) {
+    const q = query.trim().slice(0, 120);
+    const reasons = {
+        'sdk-catalog': 'Official SDK / @kit feature catalogs are outside this repo index — use SDK docs.',
+        'file-listing': 'Topic → file lists need Grep/Glob (keyword paths), not the symbol graph.',
+        'concept-or-existence': 'Concept compare / UI-behavior / existence checks without a named in-repo Type/file/@kit target — Grep (and docs) beat HomeGraph.',
+    };
+    return [
+        'Skip HomeGraph for this question shape — do **not** retry any `homegraph_*` tool for it.',
+        reasons[kind],
+        `Query: "${q}${query.trim().length > 120 ? '…' : ''}"`,
+        'Next: Grep / Glob / Read / SDK docs. Call HomeGraph only for in-repo wiring, callers/callees, or named-symbol flows.',
+    ].join('\n');
+}
 /**
  * Question already names files/symbols/@kit — prefer explore over FTS search.
  */
@@ -271,17 +424,95 @@ function queryShouldPreferExploreOverSearch(query) {
     const q = query.trim();
     if (!q)
         return false;
+    if (queryLooksLikeLiteralOrCopyHunt(query))
+        return false;
     if (/^[A-Za-z_][\w]*$/.test(q))
         return true;
     if (extractFileBasenamesFromQuery(query).length > 0
         || extractTypeNamesFromQuery(query).length > 0
         || extractMemberAccessFromQuery(query).length > 0
         || extractImportSearchTerms(query).length > 0
-        || extractKitModuleNamesFromQuery(query).length > 0) {
+        || extractKitModuleNamesFromQuery(query).length > 0
+        || extractFieldLikeSymbolsFromQuery(query).length > 0
+        || queryAsConstantUsageSurvey(query)
+        || queryAsDeclarationSiteSurvey(query)
+        || queryAsFieldUsageSurvey(query)
+        || queryAsModuleExportSurvey(query)
+        || queryAsModuleDependencySurvey(query)
+        || queryAsDtsWrapSurvey(query)
+        || shouldBuildApiUsageSurvey(query)
+        || queryAsAssignedFlagImpactSurvey(query)
+        || queryAsNativeRenderThreadSurvey(query)
+        || queryAsInRepoSystemCapabilityHowto(query)
+        || shouldBuildHoverHandlerSurvey(query)
+        || queryAsDataSourceSurvey(query)
+        || queryAsksKitInstallDeps(query)
+        || queryAsTypeLifecycleSurvey(query)
+        || shouldBuildCallerInventory(query)) {
         return true;
     }
     return extractDependencySymbolsFromQuery(query).some((d) => isDistinctiveIdentifier(d));
 }
+/**
+ * In-repo pointer/hover handler inventory — no named Type yet, but the graph
+ * still has onHover / Hover* symbols. Soft-skip→Grep lost accuracy; inventory wins.
+ */
+function shouldBuildHoverHandlerSurvey(query) {
+    if (extractTypeNamesFromQuery(query).length > 0)
+        return false;
+    if (extractMemberAccessFromQuery(query).length > 0)
+        return false;
+    if (queryAsNamedComponentAction(query))
+        return false;
+    return /悬停|\bhover\b|onHover|hoverEffect|HoverAnimation|HoverConstants/i.test(query);
+}
+/**
+ * Framework decorator / ambient UI names — agents paste `@CustomDialog` etc.
+ * Keep real *Page/*Dialog types; drop these when counting UI surfaces / anchors.
+ */
+exports.FRAMEWORK_UI_DECORATOR_NAMES = new Set([
+    'customdialog', 'component', 'entry', 'builder', 'preview', 'observed', 'observable',
+    'state', 'prop', 'link', 'objectlink', 'provide', 'consume', 'watch', 'builderparam',
+]);
+function isFrameworkUiDecoratorName(name) {
+    return exports.FRAMEWORK_UI_DECORATOR_NAMES.has(name.toLowerCase());
+}
+/** PascalCase names that look like UI surfaces (Page / View / … / ThemeHome). */
+function queryLooksLikeUiComponentType(name) {
+    // `@CustomDialog` / bare `Component` match the suffix regex but are not app Types.
+    if (isFrameworkUiDecoratorName(name))
+        return false;
+    return /(Button|Component|View|Page|Dialog|Bar|Item|Panel|Menu|Chip|Card|Home)$/i.test(name);
+}
+/**
+ * 2–3 concrete UI Types named together (Page+Dialog, View+Panel, …).
+ * Must stay on compact explore — full findRelevantContext is a 15–30k / multi-minute
+ * dump for what is a local composition / resource question.
+ */
+function queryAsFocusedUiCluster(query) {
+    if (queryAsMechanismSurvey(query) || queryAsCrossModuleFlowSurvey(query))
+        return false;
+    const types = extractTypeNamesFromQuery(query).filter((t) => queryLooksLikeUiComponentType(t) && !isFrameworkUiDecoratorName(t));
+    return types.length >= 2 && types.length <= 3;
+}
+/**
+ * Named Page/Component overview: which UI children / where does it navigate /
+ * how does Page embed Dialog. Needs component bodies, not full-graph explore.
+ */
+function queryAsComponentSurfaceSurvey(query) {
+    if (queryAsFocusedUiCluster(query))
+        return true;
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    if (types.length < 1 || types.length > 3)
+        return false;
+    if (!types.some(queryLooksLikeUiComponentType))
+        return false;
+    if (/使用了哪些|哪些UI|哪些组件|UI组件|跳转到|可以跳转|内嵌|嵌入|preview|加载|page\s+navigation|which\s+(?:ui\s+)?components|navigat|embed/i.test(query)) {
+        return true;
+    }
+    // Bare / near-bare `ThemeHome` / `FooPage` — agents search("ThemeHome") for overview.
+    return queryIsTypeNameFocus(query);
+}
 /**
  * In-repo kit/import **usage** inventory (call sites / which files import).
  */
@@ -292,11 +523,23 @@ function shouldBuildKitModuleUsageSurvey(query) {
         && extractImportSearchTerms(query).length === 0) {
         return false;
     }
-    return /依赖|引用|哪里用|哪些代码|哪里调用|哪些.*(?:依赖|引用|使用)|import\s+sites?|usages?\b|\buses\b|call\s*sites?/i.test(query);
+    return (/依赖|引用|哪里用|哪些代码|哪里调用|哪些.*(?:依赖|引用|使用)|import\s+sites?|usages?\b|\buses\b|call\s*sites?/i.test(query)
+        // "调用 Kit 需要额外安装哪些依赖 / how to install deps for Kit"
+        || queryAsksKitInstallDeps(query));
+}
+/** "需要额外安装哪些依赖" — kit survey must include oh-package, not only imports. */
+function queryAsksKitInstallDeps(query) {
+    return (/额外安装|还需.*依赖|需要.*依赖|引入.*依赖|其他参数和依赖|other\s+(?:params?.{0,24})?deps?/i.test(query)
+        || /install(?:ing)?\s+(?:extra\s+)?deps?|which\s+deps?|need(?:s)?\s+(?:other\s+)?deps?/i.test(query));
 }
 /**
  * Member-access patterns from a query — `obj.method`, `Type.method`, or `.member`.
+ * Skips `@kit.X` / `@ohos.X` module paths (those are imports, not Type.member).
  */
+/** Shared-object / binary suffixes — not Type.member (libfoo.so → member "so"). */
+const FILE_EXT_MEMBER_NOISE = new Set([
+    'so', 'dll', 'dylib', 'a', 'lib', 'exe', 'apk', 'hap', 'bin', 'wasm', 'o', 'obj',
+]);
 function extractMemberAccessFromQuery(query) {
     const results = [];
     const seen = new Set();
@@ -304,12 +547,21 @@ function extractMemberAccessFromQuery(query) {
         const dotted = m[1];
         if (!dotted || seen.has(dotted))
             continue;
+        const idx = m.index ?? 0;
+        // `@kit.ArkTS` / `@ohos.foo` — module specifier, not receiver.member
+        if (idx > 0 && query[idx - 1] === '@')
+            continue;
+        if (/^(?:kit|ohos)\./i.test(dotted))
+            continue;
         const parts = dotted.split('.');
         if (parts.length < 2)
             continue;
         const member = parts[parts.length - 1];
         if (member.length < 2)
             continue;
+        // `libeffectrender.so` / `foo.dll` — not a member access.
+        if (FILE_EXT_MEMBER_NOISE.has(member.toLowerCase()))
+            continue;
         seen.add(dotted);
         results.push({
             receiver: parts.slice(0, -1).join('.'),
@@ -319,12 +571,29 @@ function extractMemberAccessFromQuery(query) {
     }
     for (const m of query.matchAll(/\.([A-Za-z_][\w]*)\b/g)) {
         const member = m[1];
+        const idx = m.index ?? 0;
+        // Skip the `.X` inside `@kit.X` / `@ohos.X`
+        const before = query.slice(0, idx);
+        if (/@(?:kit|ohos)$/i.test(before))
+            continue;
+        if (FILE_EXT_MEMBER_NOISE.has(member.toLowerCase()))
+            continue;
         const dotted = `.${member}`;
         if (seen.has(dotted))
             continue;
         seen.add(dotted);
         results.push({ member, dotted });
     }
+    // C++ / ArkTS qualified `Type::method` — same shape as dotted member access.
+    for (const m of query.matchAll(/\b([A-Za-z_][\w]*)::([A-Za-z_][\w]*)\b/g)) {
+        const receiver = m[1];
+        const member = m[2];
+        const dotted = `${receiver}::${member}`;
+        if (seen.has(dotted) || member.length < 2)
+            continue;
+        seen.add(dotted);
+        results.push({ receiver, member, dotted });
+    }
     return results;
 }
 /** Terms for targeted import-node FTS (kit modules and their @kit.* paths). */
@@ -436,22 +705,49 @@ exports.STOP_WORDS = new Set([
  * Lowercase API / import symbol names in a dependency question (taskpool, formInfo).
  * Used to filter import sites to the symbol actually asked about, not every @kit.ArkTS import.
  */
+/**
+ * Generic verbs agents put in rewritten how-implemented bags ("xml parse").
+ * Not useful as dependency/import inventory filters or local-detail anchors —
+ * they match every `parse`/`load` method and drown the distinctive token (xml).
+ */
+exports.GENERIC_VERB_ANCHOR_NOISE = new Set([
+    'parse', 'parsing', 'load', 'save', 'read', 'write', 'update', 'delete', 'create',
+    'init', 'handle', 'process', 'run', 'start', 'stop', 'open', 'close', 'convert',
+    'get', 'set', 'add', 'remove', 'list', 'show', 'find',
+    // Lifetime / allocator verbs — agents ask "where new/delete" and these must not
+    // become explore seeds (AnimateEx.new / RdbStoreHelper.delete).
+    'new', 'pointer', 'alloc', 'allocate', 'dealloc', 'deallocate', 'free', 'release',
+    // Inventory / NL fillers agents leave in rewritten bags (not real symbols).
+    'usage', 'usages', 'use', 'uses', 'using', 'api', 'apis', 'endpoint', 'endpoints',
+    'project', 'codebase', 'repo', 'documentation', 'document', 'docs', '说明',
+    // Shared-lib / GL thread NL leftovers (not symbols).
+    'context', 'opengl', 'gles', 'glesv3', 'egl',
+]);
 function extractDependencySymbolsFromQuery(query) {
     const symbols = new Set();
     for (const ma of extractMemberAccessFromQuery(query)) {
         if (ma.member.length >= 3 && !exports.STOP_WORDS.has(ma.member.toLowerCase())) {
-            symbols.add(ma.member);
+            if (!exports.GENERIC_VERB_ANCHOR_NOISE.has(ma.member.toLowerCase()))
+                symbols.add(ma.member);
         }
     }
-    for (const m of query.matchAll(/\b([a-z][a-zA-Z0-9]{3,})\b/g)) {
+    for (const f of extractFieldLikeSymbolsFromQuery(query))
+        symbols.add(f);
+    // ≥3-char lowercase tokens (includes xml); drop generic verbs.
+    for (const m of query.matchAll(/\b([a-z][a-zA-Z0-9]{2,})\b/g)) {
         const sym = m[1];
-        if (!exports.STOP_WORDS.has(sym.toLowerCase()))
-            symbols.add(sym);
+        if (exports.STOP_WORDS.has(sym.toLowerCase()))
+            continue;
+        if (exports.GENERIC_VERB_ANCHOR_NOISE.has(sym.toLowerCase()))
+            continue;
+        symbols.add(sym);
     }
     // Lowercase API tokens (statfs, napi_wrap) when the query is clearly about code.
     if (queryMentionsCodeContext(query)) {
         for (const m of query.matchAll(/\b([a-z][a-z0-9_]{4,})\b/g)) {
             const sym = m[1];
+            if (exports.GENERIC_VERB_ANCHOR_NOISE.has(sym))
+                continue;
             if (!exports.STOP_WORDS.has(sym) && isDistinctiveIdentifier(sym))
                 symbols.add(sym);
             else if (!exports.STOP_WORDS.has(sym) && sym.length >= 6)
@@ -495,7 +791,252 @@ function hasImportInventoryFilter(query) {
 }
 /** Where-is-API-used / call-site intent (statfs, snake_case APIs, "哪里使用了 X"). */
 function queryAsApiUsageSurvey(query) {
-    return (/哪里使用|何处使用|哪些地方使用|在哪里使用|什么地方使用|项目中.*使用|使用了.*API|API端点|调用.*API|使用了哪些调用|哪些调用方法|调用方法|使用了哪些方法|where\s+(?:is|are).+(?:used|called)|which\s+(?:files?|code)\s+(?:use|call)/i.test(query));
+    return (/哪里使用|何处使用|哪些地方使用|在哪里使用|什么地方使用|项目中.*使用|使用了.*API|API端点|调用.*API|使用了哪些调用|哪些调用方法|调用方法|使用了哪些方法|哪些组件使用|哪些.*使用了|使用了\s*\.|自定义绘制|where\s+(?:is|are).+(?:used|called)|which\s+(?:files?|code|components?)\s+(?:use|call)/i.test(query)
+        // Agent rewrites (Telephony API usages / call methods in the project).
+        || /\bAPI\s+usages?\b/i.test(query)
+        || /\busages?\s+(?:of|for|in)\b/i.test(query)
+        || /\bcall\s+methods?\b/i.test(query)
+        || /\b(?:used|called)\s+(?:methods?|APIs?)\b/i.test(query)
+        || /\bin(?:\s+the)?\s+project\b.{0,40}\b(?:API|usages?|methods?|calls?)\b/i.test(query)
+        || /\b(?:API|usages?|methods?|calls?)\b.{0,40}\bin(?:\s+the)?\s+project\b/i.test(query));
+}
+/**
+ * Member / field symbols agents paste for cross-file usage hunts (`m_eglMutex`,
+ * `drawModifier`). Distinct from PascalCase Types.
+ */
+function extractFieldLikeSymbolsFromQuery(query) {
+    const out = new Set();
+    for (const m of query.matchAll(/\b(m_[A-Za-z][\w]{2,})\b/g)) {
+        if (m[1])
+            out.add(m[1]);
+    }
+    for (const m of query.matchAll(/\b([A-Za-z][\w]*(?:Mutex|Lock))\b/g)) {
+        if (m[1] && m[1].length >= 4)
+            out.add(m[1]);
+    }
+    return [...out];
+}
+/** Named Type + declaration / id / native-binding sites across files. */
+function queryAsDeclarationSiteSurvey(query) {
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    if (types.length < 1 || types.length > 3)
+        return false;
+    return (/在哪些文件|哪些文件.*(?:声明|定义|出现)|被声明|声明了|id\s*分别|各自绑定|绑定到|which\s+files?.{0,80}(?:declar|defin|appear)|where\s+(?:is|are).{0,40}declar/i.test(query)
+        // Agent English rewrites: "XComponent declaration id native render binding"
+        || /\bdeclarations?\b/i.test(query)
+        || /\bdeclared\b/i.test(query)
+        || (/\bids?\b/i.test(query) && /\b(?:bind|binding|native|renderer|xcomponent)\b/i.test(query)));
+}
+/**
+ * How-to get a system setting/capability *as used in this repo* (language/locale/…).
+ * Must NOT become a light-mechanism dump of every `language` import.
+ */
+function queryAsInRepoSystemCapabilityHowto(query) {
+    if (extractTypeNamesFromQuery(query).some((t) => /Manager|Service|Controller/i.test(t))) {
+        // Named Manager data-source / lifecycle owns those questions.
+        if (queryAsDataSourceSurvey(query) || queryAsTypeLifecycleSurvey(query))
+            return false;
+    }
+    return (/如何获取系统|怎样获取系统|怎么获取系统|获取系统当前|系统当前设置|系统.*语言|当前设置的语言/i.test(query)
+        || /how\s+to\s+get\s+(?:the\s+)?system\s+(?:language|locale|setting)/i.test(query)
+        || (/\b(?:language|locale|i18n)\b/i.test(query)
+            && /(?:获取|当前设置|get\s+system|system\s+(?:language|locale))/i.test(query)));
+}
+/**
+ * "Who uses the return value of Type.member / fn" — callers of the member, not a
+ * create→get flow dump or an import flood on leftover words like `state`.
+ */
+function queryAsReturnValueConsumerSurvey(query) {
+    const hasMember = extractMemberAccessFromQuery(query).length > 0
+        || extractLocalDetailAnchors(query).some((n) => isMemberLikeIdentifier(n));
+    if (!hasMember && extractTypeNamesFromQuery(query).length === 0)
+        return false;
+    return (/返回结果被|返回值.*(?:被|由).*(?:使用|调用)|其返回.*使用|返回结果.*哪些/i.test(query)
+        || /who\s+uses\s+the\s+(?:return|result)|return(?:ed)?\s+(?:value|result).{0,80}(?:used|consum)/i.test(query)
+        || /哪些其他函数使用|被项目中哪些.{0,20}函数使用|which\s+(?:other\s+)?functions?\s+use/i.test(query));
+}
+/** ALL_CAPS constants — where used / which scenarios (not "what does this macro mean"). */
+function queryAsConstantUsageSurvey(query) {
+    const caps = [...query.matchAll(/\b([A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+)\b/g)].map((m) => m[1]);
+    // Enum-style `Type.MEMBER` / `audio.Type.RINGTONE` — ALL_CAPS member (with or without `_`).
+    const dottedCaps = [
+        ...query.matchAll(/\.[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*\b/g),
+    ]
+        .map((m) => m[0].slice(1))
+        .filter((s) => s === s.toUpperCase() && s.length >= 3);
+    const all = [...new Set([...caps, ...dottedCaps])];
+    if (all.length === 0)
+        return false;
+    return /用于|场景|哪里用|哪些.*用|依赖|调用|where\s+(?:is|are).+used|which\s+(?:scenarios?|functions?)|what\s+(?:are\s+)?(?:they|these)\s+for|which\s+methods?.{0,20}(?:call|depend)/i.test(query);
+}
+/** Field / mutex / lock — which other functions also touch it. */
+function queryAsFieldUsageSurvey(query) {
+    if (extractFieldLikeSymbolsFromQuery(query).length === 0)
+        return false;
+    return (/哪些函数|还会用到|用到这个|哪些.*(?:用到|使用)|who\s+(?:else\s+)?(?:uses|locks)|which\s+functions?.{0,40}(?:use|lock|mutex)|\bmutex\b|这[个把]锁/i.test(query)
+        // Lifetime: where is m_foo new'd / delete'd / freed.
+        || /new\s*出来|被\s*new|delete\s*掉|被\s*delete|new\s*\/\s*delete|(?:哪里|哪些地方).{0,12}(?:new|delete)|(?:new|delete).{0,20}(?:哪里|哪些)|被释放|释放掉|allocat|deallocat|where.{0,40}(?:new|delete|allocat|free)/i.test(query));
+}
+/**
+ * Native shared lib + GL/EGL thread questions (`libfoo.so` … OpenGL … 哪个线程).
+ * Light-mechanism (CMake + EGLCore/PluginRender), not `.so` member survey.
+ */
+function queryAsNativeRenderThreadSurvey(query) {
+    const hasLib = /\b\w+\.(?:so|dll|dylib)\b/i.test(query)
+        || /\blib\w+\b/i.test(query);
+    const hasGl = /\b(?:GLES(?:v3)?|EGL|OpenGL)\b/i.test(query);
+    const hasThread = /线程|thread|UI\s*线程|主线程|JS\s*主?线程/i.test(query);
+    return (hasLib || hasGl) && hasThread;
+}
+/** Named `.d.ts` wrap — what calls / imports it in-repo. */
+function queryAsDtsWrapSurvey(query) {
+    if (!/\.d\.ts\b/i.test(query) && extractFileBasenamesFromQuery(query).length === 0) {
+        return false;
+    }
+    if (!/\.d\.ts\b/i.test(query))
+        return false;
+    return /封装|wrap(?:s|ped)?|调用|哪里|功能|where|called|uses?|import/i.test(query);
+}
+/**
+ * Assigned flag / boolean field impact on later call timing
+ * (`isChangeSurface = true` … 如何影响 … 时序).
+ */
+function queryAsAssignedFlagImpactSurvey(query) {
+    const hasAssign = /=\s*(?:true|false)\b/i.test(query)
+        || /设置\s*\w+.*=/.test(query)
+        || /里设置\s+\w+/i.test(query)
+        || /\bsets?\s+\w+\s*=\s*(?:true|false)\b/i.test(query);
+    const hasImpact = /影响|时序|后续|how\s+(?:does|will).{0,40}affect|affect.{0,40}timing/i.test(query);
+    if (!hasAssign || !hasImpact)
+        return false;
+    return extractLocalDetailAnchors(query).length >= 1;
+}
+/**
+ * Named Toggle/control kept consistent across surfaces — which module guarantees it.
+ */
+function queryAsNamedControlStateSyncSurvey(query) {
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    if (types.length < 1 || types.length > 2)
+        return false;
+    return (/状态一致|保持一致|三处|哪个模块保证|who\s+keeps|consistent\s+state|state\s+sync|guarantees?\s+it|which\s+module\s+guarantees/i.test(query)
+        || (/Toggle|Switch|开关/.test(query) && /一致|保证|模块|consistent|guarantees?/i.test(query)));
+}
+/**
+ * Methods listed beside a Type for caller inventories
+ * (`BinaryGrid … Set、Test 或 Fill` — including short verbs normally treated as noise).
+ */
+function extractListedTypeMethodsFromQuery(query) {
+    if (!queryAsCallerOrMethodSurvey(query))
+        return [];
+    const types = extractTypeNamesFromQuery(query);
+    if (types.length === 0)
+        return [];
+    // Owning Type(s): longer CamelCase — short Set/Test/Fill are method tokens, not owners.
+    const owners = new Set(types.filter((t) => t.length >= 6 || /(?:Grid|Manager|Service|Controller|Render|Plugin|Layout)/i.test(t)));
+    if (owners.size === 0) {
+        // Fall back to longest type name as owner.
+        const longest = [...types].sort((a, b) => b.length - a.length)[0];
+        if (longest)
+            owners.add(longest);
+    }
+    const out = new Set();
+    // `Set、Test 或 Fill` / `Set, Test, or Fill` — list of PascalCase methods.
+    for (const m of query.matchAll(/\b([A-Z][A-Za-z0-9]{1,})(?:\s*[、,]\s*([A-Z][A-Za-z0-9]{1,}))+(?:\s*(?:或|or)\s*([A-Z][A-Za-z0-9]{1,}))?/g)) {
+        for (let i = 1; i < m.length; i++) {
+            const name = m[i];
+            if (name && !owners.has(name) && name.length >= 2)
+                out.add(name);
+        }
+    }
+    // `的 Set` / `methods Set` / `调用了 Set` (owner already required above).
+    for (const m of query.matchAll(/(?:的|of|模板类的|类的|methods?)\s+([A-Z][A-Za-z0-9]{1,})\b/g)) {
+        const name = m[1];
+        if (!owners.has(name) && name.length >= 2)
+            out.add(name);
+    }
+    return [...out].slice(0, 8);
+}
+/** Path module + NAPI / exported API surface (or named Type + NAPI/expose). */
+function queryAsModuleExportSurvey(query) {
+    const napi = /NAPI|napi|暴露了哪些|暴露哪些|暴露给|expose(?:d|s)?\s+to|napi_module_register|哪些\s*API|API\s*接口|exports?\s+(?:which|what)|which\s+(?:APIs?|exports?)/i.test(query);
+    if (!napi)
+        return false;
+    if (extractPathSegmentsFromQuery(query).length > 0)
+        return true;
+    // "LayoutRotatePacking … NAPI expose to ArkTS" — no path segment required.
+    if (extractTypeNamesFromQuery(query).length > 0)
+        return true;
+    return false;
+}
+/** Multi-module path interdependence (A/B/C… mutual deps). */
+function queryAsModuleDependencySurvey(query) {
+    const paths = extractPathSegmentsFromQuery(query);
+    const moduleTokens = query.match(/\b[A-Za-z][\w]*(?:common|service|component|constants)\b/gi) ?? [];
+    const circular = /循环依赖|circular\s+depend|互为依赖/i.test(query);
+    // "commonconstants … 循环依赖" — one module token + cycle intent is enough.
+    if (circular && (paths.length + moduleTokens.length >= 1 || /\b[a-z][a-z0-9_]{5,}\b/.test(query))) {
+        return true;
+    }
+    if (paths.length + moduleTokens.length < 2)
+        return false;
+    return /相互依赖|互相依赖|之间.*依赖|依赖关系|depend(?:ency|encies| on each other)|cross-?depend/i.test(query);
+}
+/**
+ * Single named Type + state/lifecycle/callback surface — needs the type body,
+ * not a thin callers stub.
+ */
+/**
+ * Repo-wide literal / copy / "imported text object" hunts — Grep territory.
+ * Shape-only: no PascalCase Type / file / member / kit anchors.
+ */
+function queryLooksLikeLiteralOrCopyHunt(query) {
+    if (extractTypeNamesFromQuery(query).length > 0)
+        return false;
+    if (extractFileBasenamesFromQuery(query).length > 0)
+        return false;
+    if (extractMemberAccessFromQuery(query).length > 0)
+        return false;
+    if (extractKitModuleNamesFromQuery(query).length > 0)
+        return false;
+    if (extractFieldLikeSymbolsFromQuery(query).length > 0)
+        return false;
+    return (/全仓|全搜|字面量|中文\s*(?:text|字符串)|绑了.*(?:text|文案)|literal\s+strings?/i.test(query)
+        || /从.{0,16}包.{0,40}(?:导入|import).{0,20}\btext\b|导入的\s*text\s*对象|imported\s+text\s+objects?/i.test(query));
+}
+function queryAsTypeLifecycleSurvey(query) {
+    if (queryAsCrossModuleFlowSurvey(query))
+        return false;
+    // "状态来源" is a data-source inventory, not a lifecycle body dump.
+    if (/状态来源|status\s+source|state\s+source/i.test(query))
+        return false;
+    // Release ↔ destructor compare may name CB + Manager + Render.
+    if (/析构|destructor/i.test(query)
+        && /Release|做了哪些|有没有重复|跟.+做的事|same\s+(?:work|things?)|overlap/i.test(query)) {
+        return extractLocalDetailAnchors(query).length >= 1;
+    }
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    if (types.length < 1 || types.length > 2)
+        return false;
+    return /状态机|状态变化|状态转换|状态.*回调|回调.*状态|foreground|background|lifecycle|state\s*machine|哪些状态|state\s+change|how\s+(?:are|is)\s+.+states?\s+(?:unified|distinguished)/i.test(query);
+}
+/**
+ * Member-access inventory ("which files use .drawModifier") — not Type×method
+ * interaction / Export fail wiring / Release↔dtor (those need compact bodies).
+ */
+function shouldPreferMemberUsageInventory(query) {
+    if (queryAsCoNamedTypeMethodInteraction(query))
+        return false;
+    if (queryAsTypeLifecycleSurvey(query))
+        return false;
+    if (queryAsFieldUsageSurvey(query))
+        return true;
+    if (extractMemberAccessFromQuery(query).length === 0)
+        return false;
+    // Conditional wiring / interaction / purpose → compact, not member-file list.
+    if (/失败时|还会被|是怎么|交互|析构|destructor|做了哪些|什么作用|做什么|purpose|what\s+does/i.test(query)) {
+        return false;
+    }
+    return /哪些|哪里|where|which|使用了|谁用|call\s*sites?/i.test(query);
 }
 /** API / SDK tokens named in the query — lowercase deps + PascalCase modules (Telephony). */
 function extractApiUsageTokens(query) {
@@ -505,18 +1046,46 @@ function extractApiUsageTokens(query) {
             tokens.add(d);
     }
     for (const t of extractTypeNamesFromQuery(query)) {
-        if (t.length >= 4)
+        if (t.length >= 4 && !isFrameworkUiDecoratorName(t))
             tokens.add(t);
     }
-    return [...tokens];
+    for (const ma of extractMemberAccessFromQuery(query)) {
+        if (ma.member.length >= 3)
+            tokens.add(ma.member);
+    }
+    for (const f of extractFieldLikeSymbolsFromQuery(query))
+        tokens.add(f);
+    for (const m of query.matchAll(/\b([A-Z][A-Z0-9]*(?:_[A-Z0-9]+)+)\b/g)) {
+        if (m[1] && m[1].length >= 6)
+            tokens.add(m[1]);
+    }
+    // When a PascalCase SDK/module token is present (Telephony, DrawContext), drop
+    // short lowercase bag noise agents add (`call`/`radio`/`usage`) — those flood
+    // false-positive files and tank precision.
+    const primary = [...tokens].filter((t) => (/^[A-Z]/.test(t) && t.length >= 4)
+        || t.startsWith('@')
+        || /^(?:statfs|napi_\w+)$/i.test(t)
+        || extractFieldLikeSymbolsFromQuery(query).includes(t)
+        || extractMemberAccessFromQuery(query).some((m) => m.member === t || m.dotted === t));
+    if (primary.length > 0)
+        return primary.slice(0, 8);
+    return [...tokens].filter((t) => t.length >= 4 && !exports.GENERIC_VERB_ANCHOR_NOISE.has(t.toLowerCase())).slice(0, 8);
 }
 function shouldBuildApiUsageSurvey(query) {
+    // Declaration-site surveys have their own section — do NOT also claim API-usage
+    // (that used to fire after an empty declaration scan and dump include hits).
+    if (queryAsDeclarationSiteSurvey(query))
+        return false;
+    if (queryAsConstantUsageSurvey(query))
+        return true;
+    if (queryAsFieldUsageSurvey(query))
+        return true;
     return queryAsApiUsageSurvey(query) && extractApiUsageTokens(query).length > 0;
 }
 /** Caller / method survey intent — not every PascalCase token. */
 function queryAsCallerOrMethodSurvey(query) {
-    return (/哪里调用|何处调用|谁调用|调用了|callers?\s+of|who\s+calls|called\s+by|哪些.*调用|外部.*调用|\bexternal\b/i.test(query)
-        || /哪些方法|which\s+methods|methods?\s+(?:are\s+)?called/i.test(query)
+    return (/哪里调用|何处调用|谁调用|调用了|被调用|callers?\s+of|who\s+calls|called\s+by|哪些.*调用|外部.*调用|\bexternal\b/i.test(query)
+        || /哪些方法|which\s+methods|methods?\s+(?:are\s+)?called|which\s+files?.{0,20}(?:call|invoke)/i.test(query)
         // Agents often write "Type … methods … callers" / bare "callers" without "of".
         || /\bcallers?\b/i.test(query)
         || /methods?.{0,40}\bcall/i.test(query));
@@ -563,6 +1132,9 @@ function shouldBuildCallerInventory(query) {
         && /使用了哪些调用|哪些调用方法|调用方法|使用了哪些方法/.test(query)) {
         return false;
     }
+    // Return-value consumers: list callers of the named member/fn.
+    if (queryAsReturnValueConsumerSurvey(query))
+        return true;
     // Require real caller/method intent — bare PascalCase alone is NOT enough
     // (that emptied inventory → blocked compact → 15K full explore on callbacks).
     return queryAsCallerOrMethodSurvey(query);
@@ -570,24 +1142,55 @@ function shouldBuildCallerInventory(query) {
 /** Symbols to list callers for — types, free functions (SortWidgets), snake_case APIs. */
 function extractCallerSurveySymbols(query) {
     const names = new Set(extractTypeNamesFromQuery(query));
-    if (!queryAsCallerOrMethodSurvey(query))
-        return [...names];
+    const wantMembers = queryAsCallerOrMethodSurvey(query) || queryAsReturnValueConsumerSurvey(query);
+    if (!wantMembers)
+        return [...names].filter((n) => n.length >= 3);
     for (const d of extractDependencySymbolsFromQuery(query)) {
         if (d.length >= 4)
             names.add(d);
     }
-    return [...names].filter((n) => n.length >= 3);
+    for (const ma of extractMemberAccessFromQuery(query)) {
+        names.add(ma.member);
+        if (ma.receiver)
+            names.add(ma.receiver);
+    }
+    for (const a of extractLocalDetailAnchors(query)) {
+        if (isMemberLikeIdentifier(a) || /^(?:get|set|is|has|create|on)[A-Z]/.test(a)) {
+            names.add(a);
+        }
+    }
+    // Type + listed methods (BinaryGrid Set/Test/Fill) — keep short verbs co-named with a Type.
+    for (const m of extractListedTypeMethodsFromQuery(query))
+        names.add(m);
+    // "通过 getConnectionState 获取…" — bare camelCase after 通过/via is the consumer target.
+    for (const m of query.matchAll(/(?:通过|经由|via|using|call(?:ing)?)\s*([a-z][a-zA-Z0-9]{3,})\b/g)) {
+        if (m[1] && (/^(?:get|set|is|has|create|on)[A-Z]/.test(m[1]) || isMemberLikeIdentifier(m[1]))) {
+            names.add(m[1]);
+        }
+    }
+    const all = [...names].filter((n) => n.length >= 3);
+    if (!queryAsReturnValueConsumerSurvey(query))
+        return all;
+    // Prefer the member whose return value is consumed over a preceding create/factory.
+    const preferred = all.filter((n) => /^(?:get|is|has)[A-Z]/.test(n) || /State|Result|Status|Value$/i.test(n));
+    if (preferred.length === 0)
+        return all;
+    const rest = all.filter((n) => !preferred.includes(n));
+    return [...preferred, ...rest];
 }
 /** Cross-module call-chain intent (A → B → engine). */
 function queryAsCrossModuleFlowSurvey(query) {
     const types = extractTypeNamesFromQuery(query);
     if (types.length < 2)
         return false;
-    return /经过|跨模块|调用链|链路|流程|到达|落到|再到|渲染|落盘|then\s+to|across\s+modules/i.test(query);
+    // Note: bare 渲染 alone is too common (flag-impact / UI surface) — require a
+    // real cross-hop cue with it.
+    return (/经过|跨模块|调用链|链路|流程|到达|落到|再到|落盘|then\s+to|across\s+modules/i.test(query)
+        || (/渲染/.test(query) && /跨模块|经过|再到|落到|链路|call\s*chain/i.test(query)));
 }
 /** Data-source / upstream-service intent (来源于哪个服务 / which service). */
 function queryAsDataSourceSurvey(query) {
-    return /来源于|数据来源|来自哪个|哪个系统服务|来自什么服务|data\s+source|which\s+service|来源.*服务/i.test(query);
+    return /来源于|数据来源|状态来源|来自哪个|哪个系统服务|来自什么服务|data\s+source|status\s+source|state\s+source|which\s+service|来源.*服务|如何统一或区分/i.test(query);
 }
 /**
  * Local one/few-symbol behavior or contract — NOT multi-file mechanism / inventory.
@@ -611,6 +1214,8 @@ function extractLocalDetailAnchors(query) {
         if (m[1] && m[1].length >= 4)
             names.add(m[1]);
     }
+    for (const f of extractFieldLikeSymbolsFromQuery(query))
+        names.add(f);
     // Drop path/extension/verb noise that long NL explores otherwise seed on
     // (`cpp`, `calls`, `include`, `render`…) — that ballooned neighbor fan-out.
     const ANCHOR_NOISE = new Set([
@@ -619,6 +1224,16 @@ function extractLocalDetailAnchors(query) {
         'calls', 'call', 'calling', 'called', 'callers', 'caller', 'include', 'includes', 'import', 'imports',
         'render', 'frame', 'sync', 'thread', 'subthread', 'layout', 'method', 'methods',
         'function', 'functions', 'file', 'files', 'src', 'main', 'define', 'visible',
+        'usage', 'usages', 'api', 'apis', 'project', 'codebase', 'repo',
+        'language', 'locale', 'i18n', 'radio', 'state', 'communication', 'binding',
+        'renderer', 'native', 'declaration', 'declarations', 'declared',
+        // Generic UI nouns agents leave in NL (not the PascalCase Type).
+        'dialog', 'page', 'view', 'button', 'component', 'card', 'icon', 'background',
+        'animation', 'hover', 'preview', 'image', 'resource', 'network', 'application',
+        'text', 'layout', 'layouts', 'string', 'strings', 'constant', 'constants',
+        // Shared-lib / GL leftovers after stripping `.so`.
+        'so', 'dll', 'dylib', 'libeffectrender', 'glesv3', 'opengl', 'context',
+        ...exports.GENERIC_VERB_ANCHOR_NOISE,
     ]);
     const ranked = [...names].filter((n) => n.length >= 3 && !ANCHOR_NOISE.has(n.toLowerCase()));
     // Prefer PascalCase / dotted members first — they're the real anchors.
@@ -626,7 +1241,13 @@ function extractLocalDetailAnchors(query) {
         const score = (s) => (/^[A-Z]/.test(s) ? 2 : 0) + (s.includes('.') ? 1 : 0) + Math.min(s.length, 20) / 20;
         return score(b) - score(a) || a.localeCompare(b);
     });
-    return ranked.slice(0, 4);
+    // Drop framework decorator names when a concrete UI Type is also present
+    // (`@CustomDialog` + WallpaperApplyDialog → keep only the Apply* types).
+    const hasConcreteUi = ranked.some((n) => queryLooksLikeUiComponentType(n) && !isFrameworkUiDecoratorName(n));
+    const filtered = hasConcreteUi
+        ? ranked.filter((n) => !isFrameworkUiDecoratorName(n))
+        : ranked;
+    return filtered.slice(0, 4);
 }
 /**
  * Caller survey that also asks how a co-named type becomes visible / used.
@@ -638,8 +1259,8 @@ function queryNeedsCoNamedUseBridge(query) {
     const anchors = extractLocalDetailAnchors(query);
     if (anchors.length < 2)
         return false;
-    // Narrow intent only — bare "visible/include/import" matched too many NL queries.
-    return /定义可见|确保.*可见|头文件可见|definition\s+visible|visible\s+definition|how\s+.+\s+visible/i.test(query);
+    // Narrow intent — how a co-named type becomes visible / included.
+    return /定义可见|确保.*可见|头文件可见|definition\s+visible|visible\s+definition|how\s+.+\s+visible|makes?\s+.+\s+visible|如何确保.*可见/i.test(query);
 }
 function queryAsLocalSymbolDetail(query) {
     if (queryAsCrossModuleFlowSurvey(query))
@@ -648,7 +1269,25 @@ function queryAsLocalSymbolDetail(query) {
         return false;
     if (shouldBuildKitModuleUsageSurvey(query))
         return false;
-    if (shouldBuildApiUsageSurvey(query))
+    // Cross-file API / declaration / constant / field inventories — not definition-only.
+    if (shouldBuildApiUsageSurvey(query) && !queryAsTypeLifecycleSurvey(query))
+        return false;
+    if (queryAsModuleExportSurvey(query) || queryAsModuleDependencySurvey(query))
+        return false;
+    if (queryAsInRepoSystemCapabilityHowto(query))
+        return false;
+    if (queryAsReturnValueConsumerSurvey(query))
+        return false;
+    if (queryAsDeclarationSiteSurvey(query))
+        return false;
+    // lib*.so + GL thread → light-mechanism, not compact OpenGL/context seeds.
+    if (queryAsNativeRenderThreadSurvey(query))
+        return false;
+    // Assigned flag impact → compact body. Named Toggle sync may have zero FTS
+    // hits for the Type — inventory owns that shape instead.
+    if (queryAsAssignedFlagImpactSurvey(query))
+        return true;
+    if (queryAsNamedControlStateSyncSurvey(query))
         return false;
     // Caller + co-named visibility → compact (body + callers), not inventory-only.
     if (queryNeedsCoNamedUseBridge(query))
@@ -660,8 +1299,19 @@ function queryAsLocalSymbolDetail(query) {
     // Named UI control + event: compact body + callees (not import inventory).
     if (queryAsNamedComponentAction(query))
         return true;
-    // Type.member / Type + isFoo co-named — even if the agent stripped Chinese verbs.
-    if (queryHasNamedMemberFocus(query) && !queryAsMechanismSurvey(query))
+    // Page/Component surface or 2–3 UI Type cluster — body, not full-graph explore.
+    if (queryAsComponentSurfaceSurvey(query) || queryAsFocusedUiCluster(query))
+        return true;
+    // Named Type + state/lifecycle surface — full type body.
+    if (queryAsTypeLifecycleSurvey(query))
+        return true;
+    // Release vs destructor / multi-method compare on named anchors.
+    if (extractLocalDetailAnchors(query).length >= 2
+        && /析构|destructor|有没有重复|是否重复|跟.+做的事|做了哪些事情/i.test(query)) {
+        return true;
+    }
+    // Type.member / Type + isFoo co-named — even if the agent used 怎么/如何 NL.
+    if (queryHasNamedMemberFocus(query))
         return true;
     if (queryAsMechanismSurvey(query))
         return false;
@@ -689,7 +1339,12 @@ function queryHasFocusedNamedAnchors(query) {
     if (shouldTryFastInventoryExplore(query))
         return false;
     const anchors = extractLocalDetailAnchors(query);
-    return anchors.length >= 1 && anchors.length <= 3;
+    if (anchors.length < 1 || anchors.length > 3)
+        return false;
+    // Require a real code anchor (PascalCase Type / member-like), not leftover
+    // English topic nouns that survived domain extraction (application, …).
+    return (extractMemberAccessFromQuery(query).length > 0
+        || anchors.some((a) => /^[A-Z]/.test(a) || isMemberLikeIdentifier(a)));
 }
 /**
  * Prefer a tight explore budget: local-detail questions, or named-symbol
@@ -702,13 +1357,14 @@ function shouldUseCompactExploreBudget(query) {
     // do not shrink those into a definition-only budget.
     if (shouldTryFastInventoryExplore(query))
         return false;
-    if (queryAsLocalSymbolDetail(query))
+    if (queryAsLocalSymbolDetail(query) || queryAsFocusedUiCluster(query) || queryAsComponentSurfaceSurvey(query)) {
         return true;
+    }
     if (queryIsTypeNameFocus(query))
         return false;
-    const types = extractTypeNamesFromQuery(query);
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
     const deps = extractDependencySymbolsFromQuery(query);
-    return types.length + deps.length >= 1 && types.length <= 2;
+    return types.length + deps.length >= 1 && types.length <= 3;
 }
 /** Keep rendering to files that define symbols named in the query. */
 function shouldFocusOnQueryNamedDefs(query, hasFlowPath, multiAnchorQuery) {
@@ -762,21 +1418,124 @@ function extractMechanismEntrySeeds(query) {
             seeds.add(term);
         }
     }
+    // Shared-lib + GLES/EGL thread — seed the usual native GL owners (not `.so` / Context).
+    if (queryAsNativeRenderThreadSurvey(query)) {
+        seeds.add('EGLCore');
+        seeds.add('PluginRender');
+        if (/\bCMakeLists\b|\.so\b|链接|link/i.test(query))
+            seeds.add('CMakeLists');
+    }
+    // Theme pack download→parse→install — agents often omit PascalCase names.
+    if (/主题|theme\s*pack|theme\s*package/i.test(query) && /安装|解析|下载|install|parse|download/i.test(query)) {
+        for (const s of [
+            'ThemePackParser', 'ThemePackageInstaller', 'SkinInstaller', 'IconsInstaller', 'FontInstaller',
+        ]) {
+            seeds.add(s);
+        }
+    }
+    // Notification subscribe/manage howto — same pattern (CJK domain, no Type named).
+    if (/通知|notification/i.test(query) && /订阅|subscribe|管理|manage|多线程|multithread/i.test(query)) {
+        for (const s of ['NotificationManager', 'NotificationSubscriber', 'AnsManager', 'SubscribeCallback']) {
+            seeds.add(s);
+        }
+    }
+    // XML parse howto — seed the real API, not bare `xml` (which floods every Xml* path).
+    if (/\bxml\b|xml解析|解析xml/i.test(query) && /解析|parse|convert|实现/i.test(query)) {
+        for (const s of ['convertxml', 'XmlParseUtil', 'ConvertXML', 'fastConvertToJSObject']) {
+            seeds.add(s);
+        }
+    }
     return [...seeds].filter((s) => s.length >= 3).slice(0, 12);
 }
 /**
  * Lightweight mechanism explore — seed symbols + flow spine only, no full
  * findRelevantContext (keeps MCP calls fast and avoids agent grep fallback).
+ *
+ * Domain-mechanism *bag*: agents often strip the how-phrase and keep only
+ * keywords (`xml parse`, `foo convert`). Structural — distinctive ASCII token
+ * plus an action verb or a CJK domain token; named Types take other paths.
  */
+function queryAsDomainMechanismBag(query) {
+    if (queryAsMechanismSurvey(query))
+        return false;
+    if (queryAsInterpretationSurvey(query))
+        return false;
+    // Named Type / Type.member / UI control → compact / inventory / click-flow.
+    if (extractTypeNamesFromQuery(query).length > 0)
+        return false;
+    if (extractMemberAccessFromQuery(query).length > 0)
+        return false;
+    if (queryAsNamedComponentAction(query))
+        return false;
+    // Hover/悬停 bags without a how-implemented cue are UI-behavior, not mechanism.
+    if (/悬停|\bhover\b|onHover/i.test(query)
+        && !/\b(?:parse|implement|manage|handle|process|subscribe|convert)\b/i.test(query)) {
+        return false;
+    }
+    const domain = extractDomainSearchTerms(query);
+    const distinct = domain.filter((t) => /^[A-Za-z][A-Za-z0-9._-]{2,}$/.test(t) && !exports.GENERIC_VERB_ANCHOR_NOISE.has(t.toLowerCase()));
+    if (distinct.length === 0)
+        return false;
+    const hasActionVerb = domain.some((t) => exports.GENERIC_VERB_ANCHOR_NOISE.has(t.toLowerCase()))
+        || /\b(?:parse|implement|manage|handle|process|subscribe|convert|encode|decode)(?:s|d|ing)?\b/i.test(query);
+    // Remaining CJK tokens are the topic half of a rewritten how-question bag.
+    const hasCjkDomain = domain.some((t) => /[\u4e00-\u9fff]/.test(t));
+    return hasActionVerb || hasCjkDomain;
+}
 function shouldTryLightMechanismExplore(query) {
     if (queryAsCrossModuleFlowSurvey(query))
         return false;
     if (queryAsInterpretationSurvey(query))
         return false;
-    // Named UI control + event → seed the control and follow callees (click flow).
-    if (queryAsNamedComponentAction(query)) {
-        return extractTypeNamesFromQuery(query).length >= 1
-            || extractMechanismEntrySeeds(query).length >= 1;
+    // Literal / copy hunts → Grep (never light dump).
+    if (queryLooksLikeLiteralOrCopyHunt(query))
+        return false;
+    // System-setting howto → lean capability inventory, not every `language` import.
+    if (queryAsInRepoSystemCapabilityHowto(query))
+        return false;
+    // Return-value consumers → callers of the member, not a seed+flow dump.
+    if (queryAsReturnValueConsumerSurvey(query))
+        return false;
+    // Manager data/status source → inventory, not light-mechanism.
+    if (queryAsDataSourceSurvey(query))
+        return false;
+    // Named UI control + event → compact (body + callees + usage sites), not light-mechanism.
+    if (queryAsNamedComponentAction(query))
+        return false;
+    if (queryAsAssignedFlagImpactSurvey(query) || queryAsNamedControlStateSyncSurvey(query)) {
+        return false;
+    }
+    // Kit in-repo usage / extra-deps → kit inventory, not a mechanism dump.
+    if (shouldBuildKitModuleUsageSurvey(query))
+        return false;
+    // Caller + "how is Type visible" → compact (callers + include), not light.
+    if (queryNeedsCoNamedUseBridge(query))
+        return false;
+    // Named Type.member / UI cluster / local pinpoint → compact, even if NL has 怎么/如何.
+    if (queryHasNamedMemberFocus(query)
+        || queryAsFocusedUiCluster(query)
+        || queryAsComponentSurfaceSurvey(query)
+        || queryAsLocalSymbolDetail(query)) {
+        return false;
+    }
+    // Declaration / constant / field / module-export inventories own these shapes.
+    if (queryAsDeclarationSiteSurvey(query)
+        || queryAsConstantUsageSurvey(query)
+        || queryAsFieldUsageSurvey(query)
+        || queryAsModuleExportSurvey(query)
+        || queryAsModuleDependencySurvey(query)
+        || queryAsTypeLifecycleSurvey(query)
+        || shouldBuildApiUsageSurvey(query)
+        || queryAsDtsWrapSurvey(query)) {
+        return false;
+    }
+    // lib*.so + GLES/EGL + which thread → CMake/EGLCore spine, not `.so` member dump.
+    if (queryAsNativeRenderThreadSurvey(query))
+        return true;
+    if (queryAsDomainMechanismBag(query)) {
+        if (queryLooksLikeLiteralOrCopyHunt(query))
+            return false;
+        return extractDomainSearchTerms(query).length >= 1;
     }
     if (!queryAsMechanismSurvey(query))
         return false;
@@ -793,38 +1552,76 @@ function shouldTryFastInventoryExplore(query) {
         return false;
     if (queryAsInterpretationSurvey(query))
         return false;
+    if (queryLooksLikeLiteralOrCopyHunt(query))
+        return false;
     // Caller paths alone cannot answer "which call makes Type X visible" — compact.
     if (queryNeedsCoNamedUseBridge(query))
         return false;
-    // One named symbol / UI action / Type.member — inventory path is the wrong shape
-    // (returns import sites for isExpired/onClick and agents fall back to Grep).
-    if (queryAsLocalSymbolDetail(query) || queryHasNamedMemberFocus(query) || queryAsNamedComponentAction(query)) {
+    // Type lifecycle / Release↔destructor compares need bodies, not path lists.
+    if (queryAsTypeLifecycleSurvey(query))
+        return false;
+    // Type×method interaction (CanPlace/Place ↔ Grid) → compact, not member inventory.
+    if (queryAsCoNamedTypeMethodInteraction(query))
+        return false;
+    // Import / kit-usage / domain / API / config / data-source listings win even if
+    // a dotted `@kit.X` once looked like Type.member (defense in depth).
+    // Member-pattern inventories only when the question is a usage listing.
+    if (shouldBuildKitModuleUsageSurvey(query)
+        || shouldBuildApiUsageSurvey(query)
+        || shouldBuildDomainFileSurvey(query)
+        || shouldBuildConfigSection(query)
+        || queryAsDataSourceSurvey(query)
+        || shouldBuildHoverHandlerSurvey(query)
+        || queryAsModuleExportSurvey(query)
+        || queryAsModuleDependencySurvey(query)
+        || queryAsDtsWrapSurvey(query)
+        || queryAsNamedControlStateSyncSurvey(query)
+        || shouldPreferMemberUsageInventory(query)
+        || queryAsInRepoSystemCapabilityHowto(query)
+        || queryAsReturnValueConsumerSurvey(query)
+        || queryAsDeclarationSiteSurvey(query)) {
+        return true;
+    }
+    // One named symbol / UI action / Type.member / component surface — inventory is wrong.
+    if (queryAsLocalSymbolDetail(query)
+        || queryHasNamedMemberFocus(query)
+        || queryAsNamedComponentAction(query)
+        || queryAsComponentSurfaceSurvey(query)
+        || queryAsFocusedUiCluster(query)) {
         return false;
     }
     const types = extractTypeNamesFromQuery(query);
-    if (types.length >= 2 && !queryAsCallerOrMethodSurvey(query))
+    if (types.length >= 2 && !queryAsCallerOrMethodSurvey(query) && !queryAsInheritanceSurvey(query)) {
         return false;
+    }
     const inventoryDeps = extractDependencySymbolsFromQuery(query).filter((d) => !isMemberLikeIdentifier(d));
-    return (shouldBuildDomainFileSurvey(query)
-        || shouldBuildApiUsageSurvey(query)
-        || shouldBuildKitModuleUsageSurvey(query)
-        || (hasImportInventoryFilter(query)
-            && (inventoryDeps.length > 0 || extractKitModuleNamesFromQuery(query).length > 0)
-            && inventoryDeps.length > 0)
+    return ((hasImportInventoryFilter(query)
+        && (inventoryDeps.length > 0 || extractKitModuleNamesFromQuery(query).length > 0)
+        && inventoryDeps.length > 0)
         || shouldBuildCallerInventory(query)
-        || shouldBuildInheritanceSurvey(query)
-        || shouldBuildMemberSurvey(query)
-        || shouldBuildConfigSection(query)
-        || queryAsDataSourceSurvey(query));
+        || shouldBuildInheritanceSurvey(query));
 }
 function shouldBuildInheritanceSurvey(query) {
     if (queryAsInheritanceSurvey(query) && extractTypeNamesFromQuery(query).length > 0)
         return true;
+    // UI Page/Component overview needs the body — not an empty subtype list.
+    if (queryAsComponentSurfaceSurvey(query))
+        return false;
     // Bare / near-bare type queries — agent search("Foo") for subtypes/overview.
-    return queryIsTypeNameFocus(query);
+    if (queryIsTypeNameFocus(query)) {
+        const types = extractTypeNamesFromQuery(query);
+        if (types.some(queryLooksLikeUiComponentType))
+            return false;
+        return true;
+    }
+    return false;
 }
 function shouldBuildMemberSurvey(query) {
-    return extractMemberAccessFromQuery(query).length > 0;
+    const members = extractMemberAccessFromQuery(query);
+    if (members.length > 0)
+        return true;
+    // Field/mutex co-use without a leading dot still needs the text-usage inventory.
+    return queryAsFieldUsageSurvey(query);
 }
 function shouldBuildConfigSection(query) {
     return queryNamesConfigFile(query);
@@ -851,28 +1648,28 @@ function extractDomainSearchTerms(query) {
         terms.delete(kit);
         terms.delete(kit.charAt(0).toLowerCase() + kit.slice(1));
     }
+    // Always keep ASCII code tokens (xml, parse, subscribe…) — mechanism NL often
+    // mixes them with Chinese and used to drop them unless a @kit/path was present.
+    for (const m of query.matchAll(/\b([A-Za-z][A-Za-z0-9]{2,})\b/g)) {
+        const w = m[1];
+        if (!exports.STOP_WORDS.has(w.toLowerCase()))
+            terms.add(w);
+    }
     const stripped = query
         .replace(/[@#][\w.]+/g, ' ')
-        .replace(/哪些文件|有哪些|什么|如何|怎样|怎么|项目中|项目里|项目|涉及|相关的?|文件|模块|功能|吗|？|\?|有使用|是否|有没有|使用|不同|区别|对比|这个|那个|是怎样|是如何|怎么|如何|它与|它和/g, ' ')
+        .replace(/哪些文件|有哪些|什么|如何|怎样|怎么|项目中|项目里|项目|涉及|相关的?|文件|模块|功能|吗|？|\?|有使用|是否|有没有|使用|不同|区别|对比|这个|那个|是怎样|是如何|怎么|如何|它与|它和|实现|的/g, ' ')
         .replace(/\s+/g, ' ')
         .trim();
-    for (const m of stripped.matchAll(/[\u4e00-\u9fff]{2,12}/g)) {
+    for (const m of stripped.matchAll(/[\u4e00-\u9fff]{2,8}/g)) {
         let t = m[0].replace(/^与/, '');
         if (t.length >= 2)
             terms.add(t);
     }
-    if (queryMentionsCodeContext(query)) {
-        for (const m of query.matchAll(/\b([a-z][a-zA-Z0-9]{4,})\b/g)) {
-            const w = m[1];
-            if (!exports.STOP_WORDS.has(w.toLowerCase()))
-                terms.add(w);
-        }
-    }
     return [...terms].filter((t) => t.length >= 2).slice(0, 12);
 }
 /** How/implementation/mechanism intent — needs entry symbols + flow, not flat file list. */
 function queryAsMechanismSurvey(query) {
-    return /如何(?:实现|获取|做|处理|管理)|怎样(?:实现|获取|做)|怎么(?:实现|获取|做)|是如何|是怎么|how\s+(?:is|does|are|to\s+(?:get|implement|work))|机制|流程|架构|多线程|多进程|multithread|multi-thread/i.test(query);
+    return /如何(?:实现|获取|做|处理|管理)|怎样(?:实现|获取|做)|怎么(?:实现|获取|做)|是如何|是怎么|how\s+(?:is|does|are|to\s+(?:get|implement|work))|机制|流程|架构|多线程|多进程|multithread|multi-thread|会走到哪些|步骤中会|解析和安装|下载完|下载后/i.test(query);
 }
 /**
  * Broad domain survey — related files, usage existence, or concept comparison.
@@ -881,6 +1678,8 @@ function queryAsMechanismSurvey(query) {
 function queryAsDomainFileSurvey(query) {
     if (queryAsKitModuleCapabilitySurvey(query))
         return false;
+    if (queryLooksLikeLiteralOrCopyHunt(query))
+        return false;
     if (queryAsCallerOrMethodSurvey(query))
         return false;
     if (shouldBuildApiUsageSurvey(query))
@@ -893,6 +1692,16 @@ function queryAsDomainFileSurvey(query) {
         return false;
     if (queryAsMechanismSurvey(query))
         return false;
+    // Module dep → dedicated cycle survey. Module NAPI export → dedicated export
+    // survey (must NOT become a 50-file domain dump of every "API"/"NAPI" token).
+    if (queryAsModuleDependencySurvey(query))
+        return true;
+    if (queryAsModuleExportSurvey(query) || queryAsDtsWrapSurvey(query))
+        return false;
+    // Step / "which code runs" flow questions are mechanism — not domain file lists.
+    if (/会走到|步骤中|解析和安装|下载完|下载后|call\s*chain|which\s+code\s+(?:runs|paths?)/i.test(query)) {
+        return false;
+    }
     const listing = /哪些文件|有哪些.*文件|相关的?\s*文件|涉及.*文件|which\s+files?|files?\s+(?:are\s+)?related/i.test(query);
     const usage = /有使用|是否使用|有没有使用|使用了.*吗|is\s+.+\s+used/i.test(query);
     const compare = /有什么不同|区别|difference|vs\.?|versus|对比/i.test(query);