@pellux/goodvibes-sdk 0.30.2 → 0.33.0

package/dist/platform/tools/find/references.js

@@ -1,8 +1,15 @@
 import { CodeIntelligence, uriToPath } from '../../intelligence/index.js';
-import { collectTextFiles, makeCountResult, makeFilesResult, makeLocationsResult, readTextFile } from './shared.js';
+import { summarizeError } from '../../utils/error-display.js';
+import { addFindWarning, collectTextFiles, createFindDiagnostics, makeCountResult, makeFilesResult, makeLocationsResult, readTextFile, withFindWarnings, } from './shared.js';
+function withFallbackReason(result, reason) {
+    return { ...result, fallback_reason: reason };
+}
 export async function executeReferencesQuery(query, output, projectRoot) {
     const maxResults = output.max_results ?? 100;
     let locations = [];
+    let lspFallbackReason = 'lsp returned no reference locations';
+    let skippedInvalidLspUris = 0;
+    const diagnostics = createFindDiagnostics();
     const ci = new CodeIntelligence({});
     try {
         const lspLocations = await ci.getReferences(query.file, query.line, query.column);
@@ -14,24 +21,33 @@ export async function executeReferencesQuery(query, output, projectRoot) {
                     const filePath = uriToPath(loc.uri);
                     locations.push({ file: filePath, line: loc.range.start.line + 1 });
                 }
-                catch {
-                    // skip invalid URIs
+                catch (err) {
+                    skippedInvalidLspUris++;
+                    addFindWarning(diagnostics, `Skipped invalid LSP reference URI '${loc.uri}': ${summarizeError(err)}`);
                 }
             }
-            if (output.format === 'count_only')
-                return makeCountResult(locations.length);
+            const source = skippedInvalidLspUris > 0 ? 'lsp_with_invalid_uri_skips' : undefined;
+            if (output.format === 'count_only') {
+                return withFindWarnings(skippedInvalidLspUris > 0
+                    ? { ...makeCountResult(locations.length, source), invalid_lsp_uri_count: skippedInvalidLspUris }
+                    : makeCountResult(locations.length), diagnostics.warnings);
+            }
             if (output.format === 'files_only') {
                 const uniqueFiles = [...new Set(locations.map((l) => l.file))];
-                return makeFilesResult(uniqueFiles, locations.length);
+                return withFindWarnings(skippedInvalidLspUris > 0
+                    ? { ...makeFilesResult(uniqueFiles, locations.length, source), invalid_lsp_uri_count: skippedInvalidLspUris }
+                    : makeFilesResult(uniqueFiles, locations.length), diagnostics.warnings);
             }
-            return makeLocationsResult(locations, locations.length);
+            return withFindWarnings(skippedInvalidLspUris > 0
+                ? { ...makeLocationsResult(locations, locations.length, source), invalid_lsp_uri_count: skippedInvalidLspUris }
+                : makeLocationsResult(locations, locations.length), diagnostics.warnings);
         }
     }
-    catch {
-        // LSP unavailable — fall through to grep fallback
+    catch (err) {
+        lspFallbackReason = `lsp unavailable: ${summarizeError(err)}`;
     }
     if (!query.symbol) {
-        return makeLocationsResult([], 0, 'fallback');
+        return withFindWarnings(withFallbackReason(makeLocationsResult([], 0, 'grep_fallback'), `${lspFallbackReason}; no symbol supplied for grep fallback`), diagnostics.warnings);
     }
     let regex;
     try {
@@ -40,11 +56,11 @@ export async function executeReferencesQuery(query, output, projectRoot) {
     catch {
         return { error: `Invalid symbol name: ${query.symbol}` };
     }
-    const files = await collectTextFiles(projectRoot);
+    const files = await collectTextFiles(projectRoot, diagnostics);
     for (const file of files) {
         if (locations.length >= maxResults)
             break;
-        const content = await readTextFile(file);
+        const content = await readTextFile(file, diagnostics);
         if (content === null)
             continue;
         const lines = content.split('\n');
@@ -57,11 +73,12 @@ export async function executeReferencesQuery(query, output, projectRoot) {
             }
         }
     }
-    if (output.format === 'count_only')
-        return makeCountResult(locations.length, 'fallback');
+    if (output.format === 'count_only') {
+        return withFindWarnings(withFallbackReason(makeCountResult(locations.length, 'grep_fallback'), lspFallbackReason), diagnostics.warnings);
+    }
     if (output.format === 'files_only') {
         const uniqueFiles = [...new Set(locations.map((l) => l.file))];
-        return makeFilesResult(uniqueFiles, locations.length, 'fallback');
+        return withFindWarnings(withFallbackReason(makeFilesResult(uniqueFiles, locations.length, 'grep_fallback'), lspFallbackReason), diagnostics.warnings);
     }
-    return makeLocationsResult(locations, locations.length, 'fallback');
+    return withFindWarnings(withFallbackReason(makeLocationsResult(locations, locations.length, 'grep_fallback'), lspFallbackReason), diagnostics.warnings);
 }

package/dist/platform/tools/find/schema.js

@@ -223,7 +223,7 @@ export const findSchema = {
                         description: 'Expand each content match to its enclosing scope. ' +
                             "'function' expands to the enclosing function/method, 'class' to the enclosing class. " +
                             'Adds startLine and endLine fields to each match. ' +
-                            'Requires tree-sitter grammar for the file language; silently ignored otherwise. ' +
+                            'Requires tree-sitter grammar for the file language; results remain unexpanded when unavailable. ' +
                             "'line' and 'block' are accepted but currently behave the same as no expansion.",
                     },
                     max_results: {

package/dist/platform/tools/find/shared.d.ts

@@ -3,44 +3,44 @@ export type SymbolKind = 'function' | 'class' | 'interface' | 'type' | 'variable
 export interface QueryBase {
     id: string;
     mode: 'files' | 'content' | 'symbols' | 'references' | 'structural';
-    path?: string;
+    path?: string | undefined;
 }
 export interface FilesQuery extends QueryBase {
     mode: 'files';
-    patterns?: string[];
-    exclude?: string[];
-    min_size?: number;
-    max_size?: number;
-    modified_after?: string;
-    modified_before?: string;
-    respect_gitignore?: boolean;
-    sort_by?: 'name' | 'size' | 'modified';
-    sort_order?: 'asc' | 'desc';
-    has_content?: string;
-    is_empty?: boolean;
-    follow_symlinks?: boolean;
-    include_hidden?: boolean;
+    patterns?: string[] | undefined;
+    exclude?: string[] | undefined;
+    min_size?: number | undefined;
+    max_size?: number | undefined;
+    modified_after?: string | undefined;
+    modified_before?: string | undefined;
+    respect_gitignore?: boolean | undefined;
+    sort_by?: 'name' | 'size' | 'modified' | undefined;
+    sort_order?: 'asc' | 'desc' | undefined;
+    has_content?: string | undefined;
+    is_empty?: boolean | undefined;
+    follow_symlinks?: boolean | undefined;
+    include_hidden?: boolean | undefined;
 }
 export interface ContentQuery extends QueryBase {
     mode: 'content';
-    pattern?: string;
-    pattern_base64?: string;
-    glob?: string;
-    case_sensitive?: boolean;
-    whole_word?: boolean;
-    multiline?: boolean;
-    negate?: boolean;
-    ranked?: boolean;
-    preview_replace?: string;
-    relationships?: boolean;
+    pattern?: string | undefined;
+    pattern_base64?: string | undefined;
+    glob?: string | undefined;
+    case_sensitive?: boolean | undefined;
+    whole_word?: boolean | undefined;
+    multiline?: boolean | undefined;
+    negate?: boolean | undefined;
+    ranked?: boolean | undefined;
+    preview_replace?: string | undefined;
+    relationships?: boolean | undefined;
 }
 export interface SymbolsQuery extends QueryBase {
     mode: 'symbols';
-    query?: string;
-    kinds?: SymbolKind[];
-    exported_only?: boolean;
-    include_private?: boolean;
-    group_by?: 'file' | 'kind' | 'none';
+    query?: string | undefined;
+    kinds?: SymbolKind[] | undefined;
+    exported_only?: boolean | undefined;
+    include_private?: boolean | undefined;
+    group_by?: 'file' | 'kind' | 'none' | undefined;
 }
 export interface ReferencesQuery extends QueryBase {
     mode: 'references';
@@ -52,26 +52,26 @@ export interface ReferencesQuery extends QueryBase {
 export interface StructuralQuery extends QueryBase {
     mode: 'structural';
     pattern: string;
-    lang?: 'ts' | 'tsx' | 'js' | 'jsx' | 'css' | 'html';
-    glob?: string;
+    lang?: 'ts' | 'tsx' | 'js' | 'jsx' | 'css' | 'html' | undefined;
+    glob?: string | undefined;
 }
 export type FindQuery = FilesQuery | ContentQuery | SymbolsQuery | ReferencesQuery | StructuralQuery;
 export interface OutputOptions {
-    format?: OutputFormat;
-    context_before?: number;
-    context_after?: number;
-    expand_to?: 'line' | 'block' | 'function' | 'class';
-    max_results?: number;
-    max_per_item?: number;
-    max_total_matches?: number;
-    max_tokens?: number;
-    preview_lines?: number;
-    max_line_length?: number;
+    format?: OutputFormat | undefined;
+    context_before?: number | undefined;
+    context_after?: number | undefined;
+    expand_to?: 'line' | 'block' | 'function' | 'class' | undefined;
+    max_results?: number | undefined;
+    max_per_item?: number | undefined;
+    max_total_matches?: number | undefined;
+    max_tokens?: number | undefined;
+    preview_lines?: number | undefined;
+    max_line_length?: number | undefined;
 }
 export interface FindInput {
     queries: FindQuery[];
-    output?: OutputOptions;
-    parallel?: boolean;
+    output?: OutputOptions | undefined;
+    parallel?: boolean | undefined;
 }
 type CountResult = {
     count: number;
@@ -103,25 +103,31 @@ interface CacheValue {
     totalMatches: number;
     fileMtimes: Map<string, number>;
 }
+export interface FindDiagnostics {
+    warnings: string[];
+}
 export interface ContentMatch {
     file: string;
     line: number;
     text: string;
-    startLine?: number;
-    endLine?: number;
-    context_before?: string[];
-    context_after?: string[];
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+    context_before?: string[] | undefined;
+    context_after?: string[] | undefined;
 }
+export declare function createFindDiagnostics(): FindDiagnostics;
+export declare function addFindWarning(diagnostics: FindDiagnostics | undefined, warning: string): void;
+export declare function withFindWarnings<T extends Record<string, unknown>>(result: T, warnings: readonly string[]): T;
 export declare function makeCountResult(count: number, source?: string, fileCount?: number): CountResult;
 export declare function makeFilesResult(files: string[], count: number, source?: string): FilesResult;
 export declare function makeLocationsResult<TLocation>(locations: TLocation[], count: number, source?: string): LocationsResult<TLocation>;
 export declare const VALID_SYMBOL_KINDS: Set<string>;
 export declare function isHiddenOrSkippedSegment(segment: string, includeHidden: boolean): boolean;
 export declare function shouldSkipRelativePath(relativePath: string, includeHidden: boolean): boolean;
-export declare function isBinary(filePath: string): Promise<boolean>;
-export declare function collectTextFiles(dirPath: string): Promise<string[]>;
-export declare function readTextFile(filePath: string): Promise<string | null>;
-export declare function collectGlobFiles(basePath: string, patterns: string[], includeHidden: boolean, followSymlinks: boolean): Promise<Set<string>>;
+export declare function isBinary(filePath: string, diagnostics?: FindDiagnostics): Promise<boolean>;
+export declare function collectTextFiles(dirPath: string, diagnostics?: FindDiagnostics): Promise<string[]>;
+export declare function readTextFile(filePath: string, diagnostics?: FindDiagnostics): Promise<string | null>;
+export declare function collectGlobFiles(basePath: string, patterns: string[], includeHidden: boolean, followSymlinks: boolean, diagnostics?: FindDiagnostics): Promise<Set<string>>;
 export declare function matchesGlob(glob: InstanceType<typeof Bun.Glob>, filePath: string, basePath: string): boolean;
 export declare function toSymbolKind(kind: string | undefined): SymbolKind;
 export declare function matchesSymbolQuery(name: string, queryRegex: RegExp | null): boolean;
@@ -133,11 +139,13 @@ export declare function groupByKey<T extends {
 export declare function validateSearchPath(path: string | undefined, projectRoot: string): string | {
     error: string;
 };
-export declare function buildGitignoreMatcher(gitignorePath: string): ((rel: string) => boolean) | null;
-export declare function collectFilesForSearch(basePath: string, queryGlob: string | undefined): Promise<string[]>;
+export declare function buildGitignoreMatcher(gitignorePath: string, diagnostics?: FindDiagnostics): ((rel: string) => boolean) | null;
+export declare function findNestedGitignoreFiles(basePath: string, rootGitignorePath: string): string[];
+export declare function collectFilesForSearch(basePath: string, queryGlob: string | undefined, diagnostics?: FindDiagnostics): Promise<string[]>;
 export interface ImportGraphLike {
     findImports(file: string): string[];
     findDependents(file: string): string[];
+    getWarnings?(): string[];
 }
 export declare class FindRuntimeService {
     private readonly searchCache;

package/dist/platform/tools/find/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/find/shared.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AACrJ,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAExG,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACvC,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC;AAErG,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3E,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACvE,KAAK,eAAe,CAAC,SAAS,IAAI;IAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAI/F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAE5F;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAEjI;AAED,eAAO,MAAM,kBAAkB,aAAsF,CAAC;AAGtH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAEzF;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAE5F;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcjE;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQzE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM3E;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,OAAO,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CA4BtB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG5G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAQjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEnF;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvE;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAChC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAS5B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAM5B;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CA4C9F;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AASD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgE;IAC5F,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,kBAAkB,CAAK;IAE/B,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,GAAG,IAAI;IAQhD,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAgBhD,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAkBpE"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/find/shared.ts"],"names":[],"mappings":"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"}

package/dist/platform/tools/find/shared.js

@@ -1,7 +1,9 @@
 import { resolve, relative, join } from 'node:path';
 import { stat as statAsync } from 'node:fs/promises';
-import { statSync, lstatSync, existsSync, readFileSync, realpathSync } from 'node:fs';
+import { statSync, lstatSync, existsSync, readFileSync, realpathSync, readdirSync } from 'node:fs';
 import { walkDir, WALK_SKIP_DIRS as SKIP_DIRS } from '../../utils/walk-dir.js';
+import { summarizeError } from '../../utils/error-display.js';
+import { logger } from '../../utils/logger.js';
 async function statCachedSearchFile(filePath) {
     try {
         return await statAsync(filePath);
@@ -10,6 +12,34 @@ async function statCachedSearchFile(filePath) {
         return null;
     }
 }
+const MAX_FIND_WARNINGS = 20;
+export function createFindDiagnostics() {
+    return { warnings: [] };
+}
+export function addFindWarning(diagnostics, warning) {
+    if (!diagnostics)
+        return;
+    if (diagnostics.warnings.includes(warning))
+        return;
+    if (diagnostics.warnings.length < MAX_FIND_WARNINGS) {
+        diagnostics.warnings.push(warning);
+        return;
+    }
+    const cappedWarning = `Additional find warnings suppressed after ${MAX_FIND_WARNINGS} entries.`;
+    if (!diagnostics.warnings.includes(cappedWarning))
+        diagnostics.warnings.push(cappedWarning);
+}
+export function withFindWarnings(result, warnings) {
+    if (warnings.length === 0)
+        return result;
+    const existingWarnings = Array.isArray(result.warnings)
+        ? result.warnings.filter((warning) => typeof warning === 'string')
+        : [];
+    return {
+        ...result,
+        warnings: [...existingWarnings, ...warnings],
+    };
+}
 export function makeCountResult(count, source, fileCount) {
     return fileCount !== undefined
         ? { count, file_count: fileCount, ...(source ? { source } : {}) }
@@ -29,7 +59,7 @@ export function isHiddenOrSkippedSegment(segment, includeHidden) {
 export function shouldSkipRelativePath(relativePath, includeHidden) {
     return relativePath.split('/').some((segment) => isHiddenOrSkippedSegment(segment, includeHidden));
 }
-export async function isBinary(filePath) {
+export async function isBinary(filePath, diagnostics) {
     try {
         const file = Bun.file(filePath);
         const size = file.size;
@@ -43,32 +73,41 @@ export async function isBinary(filePath) {
         }
         return false;
     }
-    catch {
+    catch (err) {
+        addFindWarning(diagnostics, `Skipped '${filePath}' because binary detection failed: ${summarizeError(err)}`);
         return true;
     }
 }
-export async function collectTextFiles(dirPath) {
+export async function collectTextFiles(dirPath, diagnostics) {
     const files = [];
     for await (const filePath of walkDir(dirPath)) {
-        if (!(await isBinary(filePath))) {
+        if (!(await isBinary(filePath, diagnostics))) {
             files.push(filePath);
         }
     }
     return files;
 }
-export async function readTextFile(filePath) {
+export async function readTextFile(filePath, diagnostics) {
     try {
         return await Bun.file(filePath).text();
     }
-    catch {
+    catch (err) {
+        addFindWarning(diagnostics, `Skipped unreadable file '${filePath}': ${summarizeError(err)}`);
         return null;
     }
 }
-export async function collectGlobFiles(basePath, patterns, includeHidden, followSymlinks) {
+export async function collectGlobFiles(basePath, patterns, includeHidden, followSymlinks, diagnostics) {
     const matchedFiles = new Set();
     const visitedRealPaths = new Set();
     for (const pattern of patterns) {
-        const glob = new Bun.Glob(pattern);
+        let glob;
+        try {
+            glob = new Bun.Glob(pattern);
+        }
+        catch (err) {
+            addFindWarning(diagnostics, `Skipped invalid glob pattern '${pattern}': ${summarizeError(err)}`);
+            continue;
+        }
         try {
             for await (const file of glob.scan({ cwd: basePath, onlyFiles: true, absolute: true, followSymlinks })) {
                 if (followSymlinks) {
@@ -78,7 +117,8 @@ export async function collectGlobFiles(basePath, patterns, includeHidden, follow
                             continue;
                         visitedRealPaths.add(real);
                     }
-                    catch {
+                    catch (err) {
+                        addFindWarning(diagnostics, `Skipped '${file}' because symlink resolution failed: ${summarizeError(err)}`);
                         continue;
                     }
                 }
@@ -88,8 +128,8 @@ export async function collectGlobFiles(basePath, patterns, includeHidden, follow
                 matchedFiles.add(file);
             }
         }
-        catch {
-            // Pattern scan failure — skip
+        catch (err) {
+            addFindWarning(diagnostics, `Glob scan failed for pattern '${pattern}': ${summarizeError(err)}`);
         }
     }
     return matchedFiles;
@@ -104,7 +144,7 @@ export function toSymbolKind(kind) {
         property: 'variable',
         namespace: 'variable',
     };
-    const mappedKind = kindMap[kind ?? ''] ?? (kind ?? 'variable');
+    const mappedKind = (kindMap[kind ?? ''] ?? kind ?? 'variable');
     return VALID_SYMBOL_KINDS.has(mappedKind) ? mappedKind : 'variable';
 }
 export function matchesSymbolQuery(name, queryRegex) {
@@ -133,14 +173,15 @@ export function validateSearchPath(path, projectRoot) {
     }
     return resolved;
 }
-export function buildGitignoreMatcher(gitignorePath) {
+export function buildGitignoreMatcher(gitignorePath, diagnostics) {
     if (!existsSync(gitignorePath))
         return null;
     let raw;
     try {
         raw = readFileSync(gitignorePath, 'utf8');
     }
-    catch {
+    catch (err) {
+        addFindWarning(diagnostics, `Could not read root .gitignore '${gitignorePath}': ${summarizeError(err)}`);
         return null;
     }
     const rules = [];
@@ -163,8 +204,8 @@ export function buildGitignoreMatcher(gitignorePath) {
         try {
             rules.push({ negate, glob: new Bun.Glob(pat) });
         }
-        catch {
-            // Skip malformed patterns
+        catch (err) {
+            addFindWarning(diagnostics, `Skipped malformed .gitignore pattern '${line}': ${summarizeError(err)}`);
         }
     }
     if (rules.length === 0)
@@ -179,11 +220,41 @@ export function buildGitignoreMatcher(gitignorePath) {
         return ignored;
     };
 }
-export async function collectFilesForSearch(basePath, queryGlob) {
+export function findNestedGitignoreFiles(basePath, rootGitignorePath) {
+    const nested = [];
+    const maxNested = 5;
+    const visit = (dir) => {
+        if (nested.length >= maxNested)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (nested.length >= maxNested)
+                return;
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                visit(full);
+            }
+            else if (entry.isFile() && entry.name === '.gitignore' && full !== rootGitignorePath) {
+                nested.push(full);
+            }
+        }
+    };
+    visit(basePath);
+    return nested;
+}
+export async function collectFilesForSearch(basePath, queryGlob, diagnostics) {
     if (!queryGlob) {
-        return collectTextFiles(basePath);
+        return collectTextFiles(basePath, diagnostics);
     }
-    return Array.from(await collectGlobFiles(basePath, [queryGlob], false, false));
+    return Array.from(await collectGlobFiles(basePath, [queryGlob], false, false, diagnostics));
 }
 const SEARCH_CACHE_MAX = 50;
 const IMPORT_GRAPH_TTL = 30_000;
@@ -238,8 +309,20 @@ export class FindRuntimeService {
         try {
             await graph.build(projectRoot);
         }
-        catch {
-            // Import graph build failure is non-fatal.
+        catch (err) {
+            const warning = `Import graph build failed; relationship results may be incomplete: ${summarizeError(err)}`;
+            logger.warn('[find] Import graph build failed', { projectRoot, error: summarizeError(err) });
+            const degradedGraph = {
+                findImports: (file) => graph.findImports(file),
+                findDependents: (file) => graph.findDependents(file),
+                getWarnings: () => [
+                    warning,
+                    ...(graph.getWarnings?.() ?? []),
+                ],
+            };
+            this.importGraph = degradedGraph;
+            this.importGraphBuiltAt = now;
+            return degradedGraph;
         }
         this.importGraph = graph;
         this.importGraphBuiltAt = now;

package/dist/platform/tools/find/symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/find/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAqB3E,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6JlC"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/find/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AA0B3E,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkKlC"}