@pellux/goodvibes-sdk 0.18.3 → 0.18.12

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

@@ -0,0 +1,152 @@
+export type OutputFormat = 'count_only' | 'files_only' | 'locations' | 'matches' | 'context' | 'with_stats' | 'with_preview' | 'signatures' | 'full';
+export type SymbolKind = 'function' | 'class' | 'interface' | 'type' | 'variable' | 'constant' | 'enum';
+export interface QueryBase {
+    id: string;
+    mode: 'files' | 'content' | 'symbols' | 'references' | 'structural';
+    path?: string;
+}
+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;
+}
+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;
+}
+export interface SymbolsQuery extends QueryBase {
+    mode: 'symbols';
+    query?: string;
+    kinds?: SymbolKind[];
+    exported_only?: boolean;
+    include_private?: boolean;
+    group_by?: 'file' | 'kind' | 'none';
+}
+export interface ReferencesQuery extends QueryBase {
+    mode: 'references';
+    symbol: string;
+    file: string;
+    line: number;
+    column: number;
+}
+export interface StructuralQuery extends QueryBase {
+    mode: 'structural';
+    pattern: string;
+    lang?: 'ts' | 'tsx' | 'js' | 'jsx' | 'css' | 'html';
+    glob?: string;
+}
+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;
+}
+export interface FindInput {
+    queries: FindQuery[];
+    output?: OutputOptions;
+    parallel?: boolean;
+}
+type CountResult = {
+    count: number;
+    file_count?: number;
+    source?: string;
+};
+type FilesResult = {
+    files: string[];
+    count: number;
+    source?: string;
+};
+type LocationsResult<TLocation> = {
+    locations: TLocation[];
+    count: number;
+    source?: string;
+};
+interface CacheKey {
+    pattern: string;
+    glob: string;
+    path: string;
+    flags: string;
+}
+interface CacheValue {
+    files: string[];
+    matchedFiles: Map<string, {
+        content: string;
+        matches: ContentMatch[];
+    }>;
+    totalMatches: number;
+    fileMtimes: Map<string, number>;
+}
+export interface ContentMatch {
+    file: string;
+    line: number;
+    text: string;
+    startLine?: number;
+    endLine?: number;
+    context_before?: string[];
+    context_after?: string[];
+}
+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 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;
+export declare function loadFileLines(filePath: string): Promise<string[]>;
+export declare function groupByKey<T extends {
+    file: string;
+    kind: string;
+}>(items: T[], groupBy: 'file' | 'kind' | 'none'): Record<string, T[]> | null;
+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 interface ImportGraphLike {
+    findImports(file: string): string[];
+    findDependents(file: string): string[];
+}
+export declare class FindRuntimeService {
+    private readonly searchCache;
+    private importGraph;
+    private importGraphBuiltAt;
+    searchCacheGet(key: CacheKey): CacheValue | null;
+    searchCacheSet(key: CacheKey, value: CacheValue): void;
+    searchCacheIsValid(cached: CacheValue): Promise<boolean>;
+    getImportGraph(projectRoot: string): Promise<ImportGraphLike>;
+}
+export {};
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/find/shared.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,240 @@
+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 { walkDir, WALK_SKIP_DIRS as SKIP_DIRS } from '../../utils/walk-dir.js';
+export function makeCountResult(count, source, fileCount) {
+    return fileCount !== undefined
+        ? { count, file_count: fileCount, ...(source ? { source } : {}) }
+        : { count, ...(source ? { source } : {}) };
+}
+export function makeFilesResult(files, count, source) {
+    return { files, count, ...(source ? { source } : {}) };
+}
+export function makeLocationsResult(locations, count, source) {
+    return { locations, count, ...(source ? { source } : {}) };
+}
+export const VALID_SYMBOL_KINDS = new Set(['function', 'class', 'interface', 'type', 'variable', 'constant', 'enum']);
+const BINARY_CHECK_BYTES = 8192;
+export function isHiddenOrSkippedSegment(segment, includeHidden) {
+    return SKIP_DIRS.has(segment) || (!includeHidden && segment.startsWith('.') && segment !== '.');
+}
+export function shouldSkipRelativePath(relativePath, includeHidden) {
+    return relativePath.split('/').some((segment) => isHiddenOrSkippedSegment(segment, includeHidden));
+}
+export async function isBinary(filePath) {
+    try {
+        const file = Bun.file(filePath);
+        const size = file.size;
+        if (size === 0)
+            return false;
+        const chunk = await file.slice(0, BINARY_CHECK_BYTES).arrayBuffer();
+        const bytes = new Uint8Array(chunk);
+        for (const byte of bytes) {
+            if (byte === 0)
+                return true;
+        }
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+export async function collectTextFiles(dirPath) {
+    const files = [];
+    for await (const filePath of walkDir(dirPath)) {
+        if (!(await isBinary(filePath))) {
+            files.push(filePath);
+        }
+    }
+    return files;
+}
+export async function readTextFile(filePath) {
+    try {
+        return await Bun.file(filePath).text();
+    }
+    catch {
+        return null;
+    }
+}
+export async function collectGlobFiles(basePath, patterns, includeHidden, followSymlinks) {
+    const matchedFiles = new Set();
+    const visitedRealPaths = new Set();
+    for (const pattern of patterns) {
+        const glob = new Bun.Glob(pattern);
+        try {
+            for await (const file of glob.scan({ cwd: basePath, onlyFiles: true, absolute: true, followSymlinks })) {
+                if (followSymlinks) {
+                    try {
+                        const real = realpathSync(file);
+                        if (visitedRealPaths.has(real))
+                            continue;
+                        visitedRealPaths.add(real);
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+                const rel = relative(basePath, file);
+                if (shouldSkipRelativePath(rel, includeHidden))
+                    continue;
+                matchedFiles.add(file);
+            }
+        }
+        catch {
+            // Pattern scan failure — skip
+        }
+    }
+    return matchedFiles;
+}
+export function matchesGlob(glob, filePath, basePath) {
+    const rel = relative(basePath, filePath);
+    return glob.match(rel) || glob.match(filePath);
+}
+export function toSymbolKind(kind) {
+    const kindMap = {
+        method: 'function',
+        property: 'variable',
+        namespace: 'variable',
+    };
+    const mappedKind = kindMap[kind ?? ''] ?? (kind ?? 'variable');
+    return VALID_SYMBOL_KINDS.has(mappedKind) ? mappedKind : 'variable';
+}
+export function matchesSymbolQuery(name, queryRegex) {
+    return queryRegex ? queryRegex.test(name) : true;
+}
+export async function loadFileLines(filePath) {
+    const raw = await readTextFile(filePath);
+    return raw === null ? [] : raw.split('\n');
+}
+export function groupByKey(items, groupBy) {
+    if (groupBy === 'none')
+        return null;
+    const grouped = {};
+    for (const item of items) {
+        const key = groupBy === 'file' ? item.file : item.kind;
+        if (!grouped[key])
+            grouped[key] = [];
+        grouped[key].push(item);
+    }
+    return grouped;
+}
+export function validateSearchPath(path, projectRoot) {
+    const resolved = path ? resolve(projectRoot, path) : projectRoot;
+    if (!resolved.startsWith(projectRoot + '/') && resolved !== projectRoot) {
+        return { error: `Path '${path}' resolves outside the project root.` };
+    }
+    return resolved;
+}
+export function buildGitignoreMatcher(gitignorePath) {
+    if (!existsSync(gitignorePath))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(gitignorePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const rules = [];
+    for (const rawLine of raw.split('\n')) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        let negate = false;
+        let pat = line;
+        if (pat.startsWith('!')) {
+            negate = true;
+            pat = pat.slice(1);
+        }
+        if (pat.endsWith('/'))
+            pat = pat.slice(0, -1);
+        if (!pat.includes('/'))
+            pat = `**/${pat}`;
+        else if (pat.startsWith('/'))
+            pat = pat.slice(1);
+        try {
+            rules.push({ negate, glob: new Bun.Glob(pat) });
+        }
+        catch {
+            // Skip malformed patterns
+        }
+    }
+    if (rules.length === 0)
+        return null;
+    return (rel) => {
+        let ignored = false;
+        for (const rule of rules) {
+            if (rule.glob.match(rel)) {
+                ignored = !rule.negate;
+            }
+        }
+        return ignored;
+    };
+}
+export async function collectFilesForSearch(basePath, queryGlob) {
+    if (!queryGlob) {
+        return collectTextFiles(basePath);
+    }
+    return Array.from(await collectGlobFiles(basePath, [queryGlob], false, false));
+}
+const SEARCH_CACHE_MAX = 50;
+const IMPORT_GRAPH_TTL = 30_000;
+function makeSearchCacheKey(key) {
+    return JSON.stringify([key.pattern, key.glob, key.path, key.flags]);
+}
+export class FindRuntimeService {
+    searchCache = new Map();
+    importGraph = null;
+    importGraphBuiltAt = 0;
+    searchCacheGet(key) {
+        const cacheKey = makeSearchCacheKey(key);
+        const entry = this.searchCache.get(cacheKey);
+        if (!entry)
+            return null;
+        entry.accessedAt = Date.now();
+        return entry.value;
+    }
+    searchCacheSet(key, value) {
+        const cacheKey = makeSearchCacheKey(key);
+        if (this.searchCache.size >= SEARCH_CACHE_MAX && !this.searchCache.has(cacheKey)) {
+            let oldestKey = '';
+            let oldestTime = Infinity;
+            for (const [candidateKey, candidateValue] of this.searchCache) {
+                if (candidateValue.accessedAt < oldestTime) {
+                    oldestTime = candidateValue.accessedAt;
+                    oldestKey = candidateKey;
+                }
+            }
+            if (oldestKey)
+                this.searchCache.delete(oldestKey);
+        }
+        this.searchCache.set(cacheKey, { value, accessedAt: Date.now() });
+    }
+    async searchCacheIsValid(cached) {
+        const entries = Array.from(cached.fileMtimes.entries());
+        const stats = await Promise.all(entries.map(([filePath]) => statAsync(filePath).catch(() => null)));
+        for (let i = 0; i < entries.length; i++) {
+            const stat = stats[i];
+            if (!stat || stat.mtimeMs !== entries[i][1])
+                return false;
+        }
+        return true;
+    }
+    async getImportGraph(projectRoot) {
+        const now = Date.now();
+        if (this.importGraph !== null && now - this.importGraphBuiltAt <= IMPORT_GRAPH_TTL) {
+            return this.importGraph;
+        }
+        const { ImportGraph } = await import('../../intelligence/import-graph.js');
+        const graph = new ImportGraph();
+        try {
+            await graph.build(projectRoot);
+        }
+        catch {
+            // Import graph build failure is non-fatal.
+        }
+        this.importGraph = graph;
+        this.importGraphBuiltAt = now;
+        return graph;
+    }
+}

package/dist/_internal/platform/tools/find/structural.d.ts

@@ -0,0 +1,3 @@
+import type { OutputOptions, StructuralQuery } from './shared.js';
+export declare function executeStructuralQuery(query: StructuralQuery, output: OutputOptions, projectRoot: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=structural.d.ts.map

package/dist/_internal/platform/tools/find/structural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/find/structural.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAqBlE,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkElC"}

package/dist/_internal/platform/tools/find/structural.js

@@ -0,0 +1,81 @@
+import { extname } from 'node:path';
+import * as astGrep from '@ast-grep/napi';
+import { collectFilesForSearch, makeCountResult, makeFilesResult, makeLocationsResult, readTextFile, validateSearchPath } from './shared.js';
+function getAstGrepLang(filePath, override) {
+    const lang = override ?? extname(filePath).slice(1).toLowerCase();
+    switch (lang) {
+        case 'ts': return astGrep.ts;
+        case 'tsx': return astGrep.tsx;
+        case 'js':
+        case 'mjs':
+        case 'cjs': return astGrep.js;
+        case 'jsx': return astGrep.jsx;
+        case 'css': return astGrep.css;
+        case 'html': return astGrep.html;
+        default: return null;
+    }
+}
+export async function executeStructuralQuery(query, output, projectRoot) {
+    const validatedPath = validateSearchPath(query.path, projectRoot);
+    if (typeof validatedPath === 'object')
+        return validatedPath;
+    const basePath = validatedPath;
+    if (!query.pattern) {
+        return { error: 'structural mode requires pattern' };
+    }
+    const format = output.format ?? 'matches';
+    const maxPerFile = output.max_per_item ?? 10;
+    const maxTotal = output.max_total_matches ?? output.max_results ?? 100;
+    const files = await collectFilesForSearch(basePath, query.glob);
+    const allMatches = [];
+    const matchedFiles = new Set();
+    let totalMatches = 0;
+    outer: for (const file of files) {
+        if (totalMatches >= maxTotal)
+            break;
+        const parser = getAstGrepLang(file, query.lang);
+        if (!parser)
+            continue;
+        const content = await readTextFile(file);
+        if (content === null)
+            continue;
+        let root;
+        try {
+            root = parser.parse(content);
+        }
+        catch {
+            continue;
+        }
+        let matches;
+        try {
+            matches = root.root().findAll(query.pattern);
+        }
+        catch {
+            continue;
+        }
+        let fileMatchCount = 0;
+        for (const match of matches) {
+            if (fileMatchCount >= maxPerFile)
+                break;
+            if (totalMatches >= maxTotal)
+                break outer;
+            const text = match.text();
+            const line = match.range().start.line + 1;
+            allMatches.push({ file, line, text });
+            matchedFiles.add(file);
+            fileMatchCount++;
+            totalMatches++;
+        }
+    }
+    if (format === 'count_only') {
+        return makeCountResult(totalMatches, undefined, matchedFiles.size);
+    }
+    if (format === 'files_only') {
+        return makeFilesResult(Array.from(matchedFiles), matchedFiles.size);
+    }
+    if (format === 'locations') {
+        const locations = allMatches.map((m) => ({ file: m.file, line: m.line }));
+        return makeLocationsResult(locations, totalMatches);
+    }
+    return { matches: allMatches, count: totalMatches };
+}

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

@@ -0,0 +1,3 @@
+import type { OutputOptions, SymbolsQuery } from './shared.js';
+export declare function executeSymbolsQuery(query: SymbolsQuery, output: OutputOptions, projectRoot: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=symbols.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/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"}

package/dist/_internal/platform/tools/find/symbols.js

@@ -0,0 +1,167 @@
+import { CodeIntelligence } from '../../intelligence/index.js';
+import { collectTextFiles, groupByKey, loadFileLines, matchesSymbolQuery, makeCountResult, makeFilesResult, toSymbolKind, validateSearchPath, readTextFile, } from './shared.js';
+export async function executeSymbolsQuery(query, output, projectRoot) {
+    const validatedPath = validateSearchPath(query.path, projectRoot);
+    if (typeof validatedPath === 'object')
+        return validatedPath;
+    const basePath = validatedPath;
+    const maxResults = output.max_results ?? 100;
+    const kindFilter = query.kinds ? new Set(query.kinds) : null;
+    const linePatterns = [
+        { kind: 'function', regex: /^export\s+(?:async\s+)?function\s+(\w+)/, exported: true },
+        { kind: 'class', regex: /^export\s+(?:abstract\s+)?class\s+(\w+)/, exported: true },
+        { kind: 'interface', regex: /^export\s+interface\s+(\w+)/, exported: true },
+        { kind: 'type', regex: /^export\s+type\s+(\w+)\s*[=<{]/, exported: true },
+        { kind: 'enum', regex: /^export\s+enum\s+(\w+)/, exported: true },
+        { kind: 'constant', regex: /^export\s+const\s+(\w+)/, exported: true },
+        { kind: 'variable', regex: /^export\s+(?:let|var)\s+(\w+)/, exported: true },
+        { kind: 'function', regex: /^(?:async\s+)?function\s+(\w+)/, exported: false },
+        { kind: 'class', regex: /^(?:abstract\s+)?class\s+(\w+)/, exported: false },
+    ];
+    const activePatterns = kindFilter ? linePatterns.filter((p) => kindFilter.has(p.kind)) : linePatterns;
+    const files = await collectTextFiles(basePath);
+    const symbols = [];
+    let queryRegex = null;
+    if (query.query) {
+        try {
+            queryRegex = new RegExp(query.query, 'i');
+        }
+        catch {
+            return { error: `Invalid symbol query pattern: ${query.query}` };
+        }
+    }
+    const ci = new CodeIntelligence({});
+    for (const file of files) {
+        if (symbols.length >= maxResults)
+            break;
+        const content = await readTextFile(file);
+        if (content === null)
+            continue;
+        let usedTreeSitter = false;
+        try {
+            const tsSymbols = await ci.getSymbols(file, content);
+            if (tsSymbols.length > 0) {
+                usedTreeSitter = true;
+                for (const sym of tsSymbols) {
+                    if (symbols.length >= maxResults)
+                        break;
+                    const kind = toSymbolKind(sym.kind);
+                    if (kindFilter && !kindFilter.has(kind))
+                        continue;
+                    if (query.exported_only && !query.include_private && !sym.exported)
+                        continue;
+                    if (!matchesSymbolQuery(sym.name, queryRegex))
+                        continue;
+                    symbols.push({ name: sym.name, kind, file, line: sym.line, exported: sym.exported });
+                }
+            }
+        }
+        catch {
+            // fall back to regex
+        }
+        if (usedTreeSitter)
+            continue;
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            if (symbols.length >= maxResults)
+                break;
+            const line = lines[i].trimStart();
+            for (const { kind, regex, exported } of activePatterns) {
+                if (query.exported_only && !query.include_private && !exported)
+                    continue;
+                const match = line.match(regex);
+                if (match) {
+                    const name = match[1];
+                    if (!name)
+                        continue;
+                    if (!matchesSymbolQuery(name, queryRegex))
+                        continue;
+                    symbols.push({ name, kind, file, line: i + 1, exported });
+                    break;
+                }
+            }
+        }
+    }
+    if (output.format === 'count_only') {
+        return makeCountResult(symbols.length);
+    }
+    if (output.format === 'files_only') {
+        const uniqueFiles = [...new Set(symbols.map((s) => s.file))];
+        return makeFilesResult(uniqueFiles, symbols.length);
+    }
+    if (output.format === 'signatures' || output.format === 'full') {
+        const fileContents = new Map();
+        const enriched = [];
+        for (const sym of symbols) {
+            let fileLines = fileContents.get(sym.file);
+            if (!fileLines) {
+                fileLines = await loadFileLines(sym.file);
+                fileContents.set(sym.file, fileLines);
+            }
+            const entry = {
+                name: sym.name,
+                kind: sym.kind,
+                file: sym.file,
+                line: sym.line,
+                exported: sym.exported,
+            };
+            const sigLines = [];
+            for (let i = sym.line - 1; i < Math.min(sym.line + 10, fileLines.length); i++) {
+                const l = fileLines[i];
+                sigLines.push(l.trimEnd());
+                if (/[{;]/.test(l))
+                    break;
+            }
+            entry.signature = sigLines.join('\n');
+            if (output.format === 'full') {
+                let jsdoc = '';
+                let j = sym.line - 2;
+                if (j >= 0 && fileLines[j]?.trimStart().startsWith('*/')) {
+                    const docLines = [];
+                    while (j >= 0 && !fileLines[j].trimStart().startsWith('/**')) {
+                        docLines.unshift(fileLines[j]);
+                        j--;
+                    }
+                    if (j >= 0)
+                        docLines.unshift(fileLines[j]);
+                    jsdoc = docLines.join('\n');
+                }
+                if (jsdoc)
+                    entry.jsdoc = jsdoc;
+                let container = '';
+                for (let k = sym.line - 2; k >= Math.max(0, sym.line - 50); k--) {
+                    const cl = fileLines[k]?.trimStart() ?? '';
+                    if (/^(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/.test(cl)) {
+                        const m = cl.match(/class\s+(\w+)/);
+                        if (m) {
+                            container = m[1];
+                            break;
+                        }
+                    }
+                    if (/^(?:export\s+)?(?:namespace|module)\s+(\w+)/.test(cl)) {
+                        const m = cl.match(/(?:namespace|module)\s+(\w+)/);
+                        if (m) {
+                            container = m[1];
+                            break;
+                        }
+                    }
+                }
+                if (container)
+                    entry.container = container;
+            }
+            enriched.push(entry);
+        }
+        const groupBy = query.group_by ?? 'none';
+        const grouped = groupByKey(enriched, groupBy);
+        if (grouped) {
+            return { symbols: grouped, count: symbols.length };
+        }
+        return { symbols: enriched, count: symbols.length };
+    }
+    const groupBy = query.group_by ?? 'none';
+    const grouped = groupByKey(symbols, groupBy);
+    if (grouped) {
+        return { symbols: grouped, count: symbols.length };
+    }
+    return { symbols, count: symbols.length };
+}

package/dist/_internal/platform/tools/inspect/executor.d.ts

@@ -0,0 +1,4 @@
+import type { InspectInput } from './schema.js';
+import { type InspectToolResult } from './shared.js';
+export declare function executeInspectMode(input: InspectInput, projectRoot: string, format: string): Promise<InspectToolResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/_internal/platform/tools/inspect/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/inspect/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AA2BrB,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CA8I5B"}