homegraph 1.5.2 → 1.5.4

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,25 @@ 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.queryAsCodeChangeOrientation = queryAsCodeChangeOrientation;
+exports.queryAsExternalManualOnly = queryAsExternalManualOnly;
+exports.queryAsGreenfieldScaffold = queryAsGreenfieldScaffold;
+exports.queryAsVcsHistoryOnly = queryAsVcsHistoryOnly;
+exports.queryAsMediaAssetInventory = queryAsMediaAssetInventory;
+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 +76,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;
@@ -71,6 +101,9 @@ exports.shouldBuildCallerInventory = shouldBuildCallerInventory;
 exports.extractCallerSurveySymbols = extractCallerSurveySymbols;
 exports.queryAsCrossModuleFlowSurvey = queryAsCrossModuleFlowSurvey;
 exports.queryAsDataSourceSurvey = queryAsDataSourceSurvey;
+exports.queryAsDataSourceDistinguishAsk = queryAsDataSourceDistinguishAsk;
+exports.queryAsMultiTypeDependencySurvey = queryAsMultiTypeDependencySurvey;
+exports.queryAsEventDispatchSurvey = queryAsEventDispatchSurvey;
 exports.extractLocalDetailAnchors = extractLocalDetailAnchors;
 exports.queryNeedsCoNamedUseBridge = queryNeedsCoNamedUseBridge;
 exports.queryAsLocalSymbolDetail = queryAsLocalSymbolDetail;
@@ -80,6 +113,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;
@@ -89,6 +123,8 @@ exports.extractDomainSearchTerms = extractDomainSearchTerms;
 exports.queryAsMechanismSurvey = queryAsMechanismSurvey;
 exports.queryAsDomainFileSurvey = queryAsDomainFileSurvey;
 exports.shouldBuildDomainFileSurvey = shouldBuildDomainFileSurvey;
+exports.mechanismDomainPathTokens = mechanismDomainPathTokens;
+exports.isDomainRoleSymbol = isDomainRoleSymbol;
 exports.isImplementationEntrySymbol = isImplementationEntrySymbol;
 exports.shouldCompactImportListing = shouldCompactImportListing;
 exports.shouldLimitToQueryNamedFile = shouldLimitToQueryNamedFile;
@@ -178,16 +214,36 @@ 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) {
+    // NL leftovers in agent rewrites ("util module API functions") — not exports.
+    const SUBMODULE_NOISE = new Set([
+        'module', 'modules', 'function', 'functions', 'feature', 'features',
+        'api', 'apis', 'capability', 'capabilities', 'export', 'exports',
+    ]);
     const names = new Set();
+    const add = (raw) => {
+        if (!raw || raw.length < 2)
+            return;
+        const s = raw.toLowerCase();
+        if (exports.STOP_WORDS.has(s) || exports.GENERIC_VERB_ANCHOR_NOISE.has(s) || SUBMODULE_NOISE.has(s))
+            return;
+        names.add(raw);
+    };
     for (const m of query.matchAll(/([a-z][a-z0-9_]{1,24})模块/gi)) {
-        if (m[1] && m[1].length >= 2)
-            names.add(m[1]);
+        add(m[1]);
     }
     for (const m of query.matchAll(/\b([a-z][a-z0-9_]*)\s+模块\b/gi)) {
-        if (m[1] && m[1].length >= 2)
-            names.add(m[1]);
+        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)) {
+        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)) {
+        add(m[1]);
     }
     return [...names];
 }
@@ -198,7 +254,9 @@ function extractKitSubmoduleNamesFromQuery(query) {
 function queryAsKitModuleCapabilitySurvey(query) {
     if (extractKitModuleNamesFromQuery(query).length === 0)
         return false;
-    const capability = /有哪些功能|有什么功能|哪些功能|模块功能|功能有哪些|what\s+(?:are\s+the\s+)?features|module\s+features|kit\s+features/i.test(query);
+    const capability = /有哪些功能|有什么功能|哪些功能|模块功能|功能有哪些|what\s+(?:are\s+the\s+)?features|module\s+features|kit\s+features/i.test(query)
+        // Agent rewrites: "@kit.ArkTS util module API functions"
+        || /(?:module\s+)?API\s+functions?|API\s+(?:list|catalog|surface)|what\s+(?:APIs?|functions?)\s+(?:does|are)/i.test(query);
     if (!capability)
         return false;
     return /@kit\.|模块|\bkit\b/i.test(query) || extractKitSubmoduleNamesFromQuery(query).length > 0;
@@ -224,6 +282,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 +312,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,21 +331,142 @@ 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).
+ * Out-of-repo SDK catalog phrasing (kit + "what features/APIs").
+ * Routed to Skip HomeGraph — graph has usages, not official feature lists.
  */
 function queryAsOutOfRepoSdkCatalog(query) {
     if (queryAsKitModuleCapabilitySurvey(query))
         return true;
-    const catalog = /有哪些(?:功能|API|接口|方法|能力)|提供(?:哪些|什么)|模块有哪些|what\s+(?:are\s+the\s+)?(?:apis?|features|methods)|(?:api|feature)\s+(?:list|catalog)|official\s+(?:api|sdk)\s+docs|module\s+features|kit\s+features/i.test(query);
-    if (!catalog)
+    const catalog = /有哪些(?:功能|API|接口|方法|能力)|提供(?:哪些|什么)|模块有哪些|what\s+(?:are\s+the\s+)?(?:apis?|features|methods)|(?:api|feature)\s+(?:list|catalog)|official\s+(?:api|sdk)\s+docs|module\s+features|kit\s+features/i.test(query)
+        || /(?:module\s+)?API\s+functions?|API\s+(?:list|catalog|surface)/i.test(query);
+    if (catalog && /@kit\.|\b[A-Z][A-Za-z0-9]*Kit\b/i.test(query))
+        return true;
+    // Pure SDK "which callback must I implement" with no in-repo file anchor.
+    // OHAudio-style SDK tokens may parse as Types — still catalog if no .ets/.ts file.
+    const hasFile = extractFileBasenamesFromQuery(query).length > 0;
+    const types = extractTypeNamesFromQuery(query);
+    const onlySdkishTypes = types.length > 0
+        && types.every((t) => /^(?:OH|Napi|NAPI)/.test(t) || /(?:Kit|API)$/.test(t));
+    if (!hasFile
+        && (types.length === 0 || onlySdkishTypes)
+        && /(?:C\s+API|NAPI|\bOH[A-Z][A-Za-z]+\b)/i.test(query)
+        && /需要实现哪个回调|实现哪个回调|哪个回调函数|which\s+callback\s+(?:must|should|to)\s+implement|callback\s+(?:to|must)\s+(?:implement|provide)/i.test(query)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Agent is about to change an existing codebase (feature / fix / refactor).
+ * Used for explore *routing* (prefer explore / light mechanism), not Skip.
+ */
+function queryAsCodeChangeOrientation(query) {
+    const q = query.trim();
+    if (!q)
+        return false;
+    return (/(?:请)?(?:直接)?(?:在|给|为).{0,40}(?:工程|项目|代码|模块|页面|组件).{0,40}(?:新增|添加|增加|修改|改造|实现|修复|重构)/i.test(q)
+        || /(?:新增|添加|增加|修改|改造|实现|修复|重构|接入|改一下|帮我改).{0,40}(?:功能|逻辑|页面|组件|入口|按钮|接口|模块)/i.test(q)
+        || /\b(?:implement|add|introduce|wire|integrate|extend|refactor|fix|modify|update|change)\b.{0,60}\b(?:feature|page|component|module|handler|api|bug|crash|flow)\b/i.test(q)
+        || /\b(?:fix|repair|debug)\b.{0,40}\b(?:crash|bug|error|issue|regression)\b/i.test(q)
+        || /定位并修复|修复.*崩溃|修复.*闪退|find\s+(?:and\s+)?fix/i.test(q));
+}
+/** Explicit "answer from official docs / website only" — no repo graph needed. */
+function queryAsExternalManualOnly(query) {
+    return (/(?:请)?(?:只|仅)?(?:查阅|查看|打开|去看|参考)(?:一下)?(?:官方|官网)(?:文档|手册|网站)/i.test(query)
+        || /developer\.huawei\.com|华为开发者(?:联盟|官网)/i.test(query)
+        || /according\s+to\s+(?:the\s+)?official\s+(?:sdk\s+)?docs?(?:\s+only)?/i.test(query)
+        || /(?:read|see|check)\s+(?:the\s+)?official\s+(?:documentation|docs|website)\s+only/i.test(query)
+        || /不要看代码.*(?:文档|官网)|(?:文档|官网).*(?:不要|别)看代码/i.test(query));
+}
+/** Scaffold / empty project from scratch — nothing useful in an existing index. */
+function queryAsGreenfieldScaffold(query) {
+    return (/从零(?:开始)?(?:创建|新建|搭建)|创建(?:一个)?空的(?:工程|项目|应用)|新建(?:一个)?空白(?:工程|项目)/i.test(query)
+        || /create\s+(?:a\s+)?(?:new\s+)?(?:empty\s+)?(?:harmonyos\s+|arkts\s+)?(?:project|app)\s+from\s+scratch/i.test(query)
+        || /scaffold\s+(?:a\s+)?(?:brand\s+)?new\s+(?:empty\s+)?project/i.test(query));
+}
+/** Git / VCS history — not in the symbol graph. */
+function queryAsVcsHistoryOnly(query) {
+    return (/\bgit\s+(?:log|blame|diff|show|bisect|history)\b/i.test(query)
+        || /(?:提交历史|commit\s+history|git\s+blame|谁改过|上次提交|最近一次提交|哪次\s*commit)/i.test(query)
+        || /(?:查看|看一下|列出).{0,12}(?:git\s+)?(?:log|blame|diff)/i.test(query));
+}
+/** Media / binary asset inventory by extension — Glob, not the symbol graph. */
+function queryAsMediaAssetInventory(query) {
+    const listing = /(?:所有|全部|列出|找(?:出|到)?|盘点|有哪些|which|list|find|inventory)\b/i.test(query)
+        || /资源文件|图片资源|音频资源|媒体资源|media\s+assets?/i.test(query);
+    if (!listing)
         return false;
-    return /@kit\.|\b[A-Z][A-Za-z0-9]*Kit\b/i.test(query);
+    return (/\.(?:png|jpe?g|gif|svg|webp|bmp|ico|mp4|mp3|wav|aac|flac|ttf|otf|woff2?)\b/i.test(query)
+        || /(?:png|jpe?g|gif|svg|webp|图片|图标|音频|视频|字体)\s*(?:文件|资源|assets?)/i.test(query));
+}
+function queryShouldDeferToBuiltinTools(query) {
+    const q = query.trim();
+    if (!q)
+        return null;
+    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;
+    const hasGraphAnchor = hasType || hasFile || hasMember || hasKit || hasCaps || hasField || hasPath;
+    // 1) Explicit external-manual-only asks.
+    if (queryAsExternalManualOnly(q))
+        return 'external-manual';
+    // 1b) Kit/SDK feature catalogs ("what APIs does X have") — not in-repo usage.
+    if (queryAsOutOfRepoSdkCatalog(q))
+        return 'sdk-catalog';
+    // 2) VCS history (independent of anchors — graph has no commits).
+    if (queryAsVcsHistoryOnly(q))
+        return 'vcs-history';
+    // 3) Media/binary asset inventories → Glob.
+    if (queryAsMediaAssetInventory(q))
+        return 'media-assets';
+    // 4) Greenfield empty scaffold (no existing code to orient on).
+    if (!hasGraphAnchor && queryAsGreenfieldScaffold(q))
+        return 'greenfield';
+    // 5) Repo-wide literal / copy / layout-string hunts → Grep.
+    // Layout chains (`.width('100%')`) can look like member access — still Skip.
+    if (queryLooksLikeLiteralOrCopyHunt(q))
+        return 'literal-hunt';
+    // 6) Topic → file list with no Type/file anchor → Glob/Grep.
+    if (!hasType
+        && !hasFile
+        && /哪些文件|有哪些.*文件|相关的?\s*文件|涉及.*文件|which\s+files?|files?\s+(?:are\s+)?related/i.test(q)) {
+        return 'file-listing';
+    }
+    // 7) Pure existence / concept-compare with zero graph anchors → Grep/docs.
+    if (!hasGraphAnchor
+        && /有使用|是否使用|有没有使用|使用了.*吗|是否存在|有没有完整|有什么不同|区别|difference|vs\.?|versus|对比|does\s+(?:this\s+)?(?:project|repo)\s+have|is\s+there\s+(?:a\s+)?complete/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 = {
+        'file-listing': 'Topic → file lists need Grep/Glob (keyword paths), not the symbol graph.',
+        'literal-hunt': 'Repo-wide literal / copy / layout-string hunts with no Type/file/@kit anchor — use Grep.',
+        'concept-or-existence': 'Pure existence/concept-compare with no named in-repo Type/file/@kit/@ohos anchor — Grep/docs.',
+        'external-manual': 'Question asks for official website/docs only — open the manual; HomeGraph indexes code/API graphs, not marketing pages.',
+        'sdk-catalog': 'Kit/SDK **feature or API catalogs** ("what does util export") need SDK docs — HomeGraph indexes in-repo imports/usages, not official capability lists. Rephrase as "which files import @kit.X / export Y" if you want usages.',
+        'greenfield': 'Scaffolding an empty project from scratch needs generators/docs, not an existing code graph.',
+        'vcs-history': 'Git/commit/blame/diff history is not in the symbol graph — use git / IDE history.',
+        'media-assets': 'Media/binary asset inventories (.png/.mp4/fonts/…) need Glob, not the symbol graph.',
+    };
+    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 / git / SDK docs / project generators as appropriate. Otherwise call `homegraph_explore` with the task or symbol names.',
+    ].join('\n');
 }
 /**
  * Question already names files/symbols/@kit — prefer explore over FTS search.
@@ -271,17 +475,97 @@ function queryShouldPreferExploreOverSearch(query) {
     const q = query.trim();
     if (!q)
         return false;
+    if (queryLooksLikeLiteralOrCopyHunt(query) && !queryAsCodeChangeOrientation(query))
+        return false;
+    if (queryAsCodeChangeOrientation(query))
+        return true;
     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 +576,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 +600,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 +624,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 +758,61 @@ 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', '说明',
+    // Kit-deps rewrite leftovers: "ServiceCollaborationKit import usage dependencies"
+    // must NOT become import-inventory focus (matches every `import` line).
+    'import', 'imports', 'importing', 'dependency', 'dependencies', 'deps', 'dep',
+    'param', 'params', 'parameter', 'parameters', 'extra', 'other', 'require', 'requires',
+    'calling', 'call', 'calls', 'needed', 'install', 'installing',
+    // Kit catalog rewrites: "util module API functions"
+    'module', 'modules', 'function', 'functions', 'feature', 'features',
+    'capability', 'capabilities', 'export', 'exports',
+    // Data-source EN rewrites: "badge source system service" must NOT become
+    // import-inventory focus (matches every `*Service` / ServiceExtensionAbility).
+    'service', 'services', 'source', 'sources', 'system', 'systems',
+    'upstream', 'origin', 'origins',
+    // 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 +856,273 @@ 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 + named Draw/Render/EGL owners), 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);
+    if ((hasLib || hasGl) && hasThread)
+        return true;
+    // Named Draw/Render/EGL owner + frame-sync / sub-thread (no project Type list).
+    if (/\b(?:[A-Z][A-Za-z0-9]*(?:Draw|Render)|EGL(?:Core)?|EglCore)\b/.test(query)
+        && /帧同步|撕裂|tearing|frame\s*sync|synchron|mutex|sub-?thread|子线程/i.test(query)) {
+        return true;
+    }
+    return false;
+}
+/** 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) {
+    // Prefer Toggle/Switch anchors — bag-of-words rewrites often add Control/Center noise Types.
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    const controlTypes = types.filter((t) => /Toggle|Switch|开关/i.test(t));
+    const anchors = controlTypes.length > 0 ? controlTypes : types;
+    if (anchors.length < 1 || anchors.length > 3)
+        return false;
+    return (/状态一致|保持一致|多处|多端|哪个模块保证|who\s+keeps|consistent\s+state|state\s+consistenc|state\s+sync|consistenc(?:y|ies)|guarantees?\s+it|which\s+module\s+guarantees|across\s+(?:surfaces|places)/i.test(query)
+        || (/Toggle|Switch|开关/i.test(query)
+            && /一致|保证|模块|consistenc|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) {
+    // Layout/style literal chains first — `.width('100%')` looks like member access
+    // to extractors but is Grep territory.
+    if (/检索所有\s*\.\w+\(\s*['"][^'"]+['"]\s*\)/i.test(query)
+        || /\.\w+\(\s*['"][^'"]{1,40}['"]\s*\).{0,80}\.\w+\(\s*['"][^'"]{1,40}['"]\s*\)/i.test(query)) {
+        if (extractTypeNamesFromQuery(query).length === 0
+            && extractFileBasenamesFromQuery(query).length === 0
+            && extractKitModuleNamesFromQuery(query).length === 0) {
+            return true;
+        }
+    }
+    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 +1132,51 @@ 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]);
+    }
+    // "statfs这个API端点" / "使用了statfs这个API" — Chinese demonstrative after the symbol.
+    for (const m of query.matchAll(/\b([A-Za-z_][\w]{2,})\s*这个\s*(?:API|接口|端点|方法)/gi)) {
+        if (m[1] && !exports.GENERIC_VERB_ANCHOR_NOISE.has(m[1].toLowerCase()))
+            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 +1223,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 +1233,105 @@ 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);
+    if (/来源于|数据来源|状态来源|来自哪个|哪个系统服务|来自什么服务|data\s+source|status\s+source|state\s+source|which\s+service|来源.*服务|如何统一或区分/i.test(query)) {
+        return true;
+    }
+    // Agent EN / bag-of-words rewrites of the same intent.
+    if (/\bsystem\s+service\b/i.test(query))
+        return true;
+    if (/\bupstream\s+(?:service|source|data)\b/i.test(query))
+        return true;
+    if (/\bsource\b.{0,48}\b(?:system\s+)?service\b/i.test(query))
+        return true;
+    if (/\b(?:data|status|state)\b.{0,48}\bsource\b/i.test(query))
+        return true;
+    return false;
+}
+/** "How are sources unified/distinguished" — inventory alone is Partial, not ANSWER NOW. */
+function queryAsDataSourceDistinguishAsk(query) {
+    if (/如何统一或区分|统一或区分|区分.*来源|来源.*区分|unify|distinguish|how\s+(?:are|is).{0,40}(?:unified|distinguished)/i.test(query)) {
+        return true;
+    }
+    // Rewrites may drop 「如何统一或区分」but keep 状态来源 / status|state source.
+    if (/哪个系统服务|which\s+system\s+service|来源于哪个|来自哪个系统/i.test(query)) {
+        return false;
+    }
+    if (/\bsystem\s+service\b/i.test(query) && !/状态来源|status\s*source|state.{0,24}source/i.test(query)) {
+        return false;
+    }
+    return /状态来源|status\s*source|state\s+change\s+source|state.{0,24}source/i.test(query);
+}
+/**
+ * ≥3 named Types + dependency/relationship ask — inventory edges, not a fat
+ * multi-body compact that hits the soft deadline.
+ */
+function queryAsMultiTypeDependencySurvey(query) {
+    const types = extractTypeNamesFromQuery(query).filter((t) => t.length >= 8
+        || /(?:Manager|Installer|Parser|Service|Controller|Handler|Provider|Store)$/i.test(t));
+    if (types.length < 3)
+        return false;
+    return /依赖|关系|互相|之间|调用关系|dependenc|relationship|how\s+(?:do|are).{0,40}relate|related/i.test(query);
+}
+/**
+ * Event-type → handler/Manager dispatch inventory
+ * (`FooEvent` types / which Managers handle them).
+ */
+function queryAsEventDispatchSurvey(query) {
+    const types = extractTypeNamesFromQuery(query);
+    const hasEventType = types.some((t) => /Event$/i.test(t));
+    const hasEventCue = hasEventType
+        || /\b[A-Z][A-Za-z0-9]*Event\b|事件类型|事件枚举/i.test(query);
+    if (!hasEventCue)
+        return false;
+    return /分发|分发给|哪些\s*Manager|handlers?|dispatch|routed?\s+to|handled\s+by|处理/i.test(query);
 }
 /**
  * Local one/few-symbol behavior or contract — NOT multi-file mechanism / inventory.
@@ -611,6 +1355,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 +1365,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 +1382,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` + `FooDialog` → keep only the concrete UI 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 +1400,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 +1410,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))
@@ -657,11 +1437,24 @@ function queryAsLocalSymbolDetail(query) {
         return false;
     if (queryAsDataSourceSurvey(query))
         return false;
+    if (queryAsEventDispatchSurvey(query))
+        return false;
     // 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 +1482,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 +1500,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 +1561,144 @@ function extractMechanismEntrySeeds(query) {
             seeds.add(term);
         }
     }
+    // Shared-lib + GLES/EGL thread — seed Draw/Render/EGL owners named in the query.
+    if (queryAsNativeRenderThreadSurvey(query)) {
+        for (const t of extractTypeNamesFromQuery(query))
+            seeds.add(t);
+        for (const m of query.matchAll(/\b([A-Z][A-Za-z0-9]*(?:Draw|Render|Core))\b/g)) {
+            if (m[1])
+                seeds.add(m[1]);
+        }
+        if (/\bCMakeLists\b|\.so\b|链接|link/i.test(query))
+            seeds.add('CMakeLists');
+    }
     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;
+    // Only *verb* leftovers count as the action half. Noun noise in
+    // GENERIC_VERB_ANCHOR_NOISE (`service` / `source` / `system` / `api` / …)
+    // must not turn a multi-term locator bag (`item service`) into light-mechanism.
+    const MECHANISM_BAG_NOUN_NOISE = new Set([
+        'service', 'services', 'source', 'sources', 'system', 'systems',
+        'upstream', 'origin', 'origins',
+        'usage', 'usages', 'use', 'uses', 'using',
+        'api', 'apis', 'endpoint', 'endpoints',
+        'module', 'modules', 'function', 'functions', 'feature', 'features',
+        'capability', 'capabilities', 'export', 'exports',
+        'dependency', 'dependencies', 'deps', 'dep',
+        'param', 'params', 'parameter', 'parameters',
+        'project', 'codebase', 'repo', 'documentation', 'document', 'docs',
+        'context', 'opengl', 'gles', 'glesv3', 'egl',
+        'extra', 'other', 'require', 'requires', 'needed',
+    ]);
+    const hasActionVerb = domain.some((t) => {
+        const l = t.toLowerCase();
+        return exports.GENERIC_VERB_ANCHOR_NOISE.has(l) && !MECHANISM_BAG_NOUN_NOISE.has(l);
+    })
+        || /\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 (queryShouldDeferToBuiltinTools(query))
+        return false;
     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), unless this is an edit/fix task.
+    if (queryLooksLikeLiteralOrCopyHunt(query) && !queryAsCodeChangeOrientation(query))
+        return false;
+    // Pre-edit orientation: task keywords → light mechanism seeds (domain / Type / file).
+    if (queryAsCodeChangeOrientation(query)) {
+        if (extractDomainSearchTerms(query).length >= 1
+            || extractTypeNamesFromQuery(query).length > 0
+            || extractFileBasenamesFromQuery(query).length > 0
+            || extractMemberAccessFromQuery(query).length > 0) {
+            return true;
+        }
+    }
+    // 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;
+    // Event type → Manager dispatch inventory.
+    if (queryAsEventDispatchSurvey(query))
+        return false;
+    // ≥3 Types + dependency relationship → lean inventory (not light/compact dump).
+    if (queryAsMultiTypeDependencySurvey(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;
@@ -787,44 +1709,86 @@ function shouldTryLightMechanismExplore(query) {
  * Skip expensive subgraph gathering — inventory sections alone answer the query.
  */
 function shouldTryFastInventoryExplore(query) {
+    if (queryShouldDeferToBuiltinTools(query))
+        return false;
     if (queryAsCrossModuleFlowSurvey(query))
         return false;
     if (shouldTryLightMechanismExplore(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)
+        || queryAsEventDispatchSurvey(query)
+        || queryAsMultiTypeDependencySurvey(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 +1815,35 @@ 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);
+    // Cross-Type drive / state-machine interaction — must not collapse into compact
+    // hard-ANSWER-NOW on abstract base names (Machine+Engine, Session FG/BG, …).
+    const types = extractTypeNamesFromQuery(query).filter((t) => !isFrameworkUiDecoratorName(t));
+    if (types.length >= 2
+        && /驱动|触发|状态机|状态变化|重新计算|foreground|background|layout|布局/i.test(query)) {
+        return true;
+    }
+    return /如何(?:实现|获取|做|处理|管理|驱动|触发)|怎样(?:实现|获取|做|驱动|触发)|怎么(?:实现|获取|做|驱动|触发)|是如何|是怎么|how\s+(?:is|does|are|to\s+(?:get|implement|work|drive|trigger))|机制|状态机|流程|架构|多线程|多进程|multithread|multi-thread|会走到哪些|步骤中会|解析和安装|下载完|下载后|状态变化如何|如何驱动|如何触发/i.test(query);
 }
 /**
  * Broad domain survey — related files, usage existence, or concept comparison.
@@ -881,6 +1852,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 +1866,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);
@@ -903,7 +1886,57 @@ function shouldBuildDomainFileSurvey(query) {
     return queryAsDomainFileSurvey(query) && extractDomainSearchTerms(query).length > 0;
 }
 /** Callable/class names that commonly anchor implementation flows. */
-exports.IMPLEMENTATION_ENTRY_NAME_RE = /Manager|Service|Handler|Extension|Parser|Helper|Controller|Provider|Worker|Backup|Restore|Subscription|Monitor|Coordinator|Delegate|Adapter|Factory|Processor/i;
+exports.IMPLEMENTATION_ENTRY_NAME_RE = /Manager|Service|Handler|Extension|Parser|Helper|Controller|Provider|Worker|Backup|Restore|Subscription|Monitor|Coordinator|Delegate|Adapter|Factory|Processor|Subscriber|Listener/i;
+/**
+ * ASCII path/name stems for mechanism affinity.
+ * Expands a few CJK domain nouns so `通知订阅` can match `/notification/` paths
+ * without a product-specific file blacklist.
+ */
+function mechanismDomainPathTokens(query) {
+    const out = new Set();
+    for (const t of extractDomainSearchTerms(query)) {
+        if (/^[\x00-\x7F]+$/.test(t) && t.length >= 4 && !exports.GENERIC_VERB_ANCHOR_NOISE.has(t.toLowerCase())) {
+            out.add(t.toLowerCase());
+        }
+    }
+    if (/通知/.test(query))
+        out.add('notification');
+    if (/订阅/.test(query)) {
+        out.add('subscribe');
+        out.add('subscriber');
+    }
+    if (/壁纸|wallpaper/i.test(query))
+        out.add('wallpaper');
+    if (/主题|theme/i.test(query)) {
+        out.add('theme');
+        // Prefer themeservice / themepack paths over appinstall "download/install" Managers.
+        out.add('themeservice');
+        out.add('themepack');
+    }
+    if (/备份|backup/i.test(query))
+        out.add('backup');
+    if (/恢复|restore/i.test(query))
+        out.add('restore');
+    if (/锁屏|screenlock|keyguard/i.test(query)) {
+        out.add('screenlock');
+        out.add('keyguard');
+    }
+    return [...out].slice(0, 12);
+}
+/** Class/file looks like a domain Manager/Service under matching path or name. */
+function isDomainRoleSymbol(name, filePath, domainTokens) {
+    if (!exports.IMPLEMENTATION_ENTRY_NAME_RE.test(name))
+        return false;
+    if (domainTokens.length === 0)
+        return /Manager|Subscriber|Listener$/i.test(name);
+    const blob = `${name}\n${filePath}`.toLowerCase().replace(/\\/g, '/');
+    return domainTokens.some((t) => {
+        const tl = t.toLowerCase();
+        if (tl.length < 4)
+            return false;
+        return blob.includes(tl) || blob.includes(`/${tl}/`);
+    });
+}
 function isImplementationEntrySymbol(name, domainTerms) {
     if (!exports.IMPLEMENTATION_ENTRY_NAME_RE.test(name))
         return false;
@@ -1234,6 +2267,8 @@ function isTestFile(filePath) {
         lower.includes('/__tests__/') || lower.includes('/spec/') ||
         lower.includes('/specs/') || lower.includes('/testlib/') ||
         lower.includes('/testing/') ||
+        // HarmonyOS / OpenHarmony instrumented test trees
+        lower.includes('/ohostest/') ||
         lower.startsWith('test/') || lower.startsWith('tests/') ||
         lower.startsWith('spec/') || lower.startsWith('specs/') ||
         // CamelCase test source-set dirs (Kotlin Multiplatform / Gradle / Xcode):