@justmpm/deps-consult 1.0.0

package/build/formatters/markdown-formatter.js

@@ -0,0 +1,251 @@
+// ─────────────────────────────────────────
+// deps info
+// ─────────────────────────────────────────
+export function formatPackageInfo(meta) {
+    const lines = [];
+    lines.push(`# ${meta.name}${meta.version ? `@${meta.version}` : ''}`);
+    if (meta.description)
+        lines.push(`> ${meta.description}`);
+    lines.push('');
+    const infoLines = [];
+    if (meta.license)
+        infoLines.push(`- License: ${meta.license}`);
+    if (meta.hasTypes)
+        infoLines.push('- Types: Available');
+    else
+        infoLines.push('- Types: Not found');
+    if (meta.diskSize !== undefined) {
+        infoLines.push(`- Size: ${formatBytes(meta.diskSize)}`);
+    }
+    lines.push(infoLines.join('\n'));
+    lines.push('');
+    if (meta.entrypoints.length > 0) {
+        lines.push('## Entry Points');
+        for (const ep of meta.entrypoints) {
+            const hasTypes = ep.hasTypes ? ' (typed)' : '';
+            const subpath = ep.subpath === '.' ? 'main' : ep.subpath;
+            lines.push(`- \`${subpath}\`${hasTypes}`);
+        }
+        lines.push('');
+    }
+    if (meta.dependencies && Object.keys(meta.dependencies).length > 0) {
+        lines.push('## Dependencies');
+        const deps = Object.entries(meta.dependencies);
+        const shown = deps.slice(0, 20);
+        for (const [name, version] of shown) {
+            lines.push(`- ${name}: ${version}`);
+        }
+        if (deps.length > 20) {
+            lines.push(`- ... and ${deps.length - 20} more`);
+        }
+        lines.push('');
+    }
+    if (meta.peerDependencies && Object.keys(meta.peerDependencies).length > 0) {
+        lines.push('## Peer Dependencies');
+        for (const [name, version] of Object.entries(meta.peerDependencies)) {
+            lines.push(`- ${name}: ${version}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────
+// deps api
+// ─────────────────────────────────────────
+export function formatApiSurface(symbols, kind, limit) {
+    const lines = [];
+    const grouped = groupByKind(symbols);
+    if (kind === 'all') {
+        for (const [k, syms] of Object.entries(grouped)) {
+            lines.push(`## ${pluralize(k)} (${syms.length})`);
+            lines.push('');
+            const shown = syms.slice(0, limit);
+            for (const sym of shown) {
+                lines.push(formatSymbolCompact(sym));
+            }
+            if (syms.length > limit) {
+                lines.push(`... and ${syms.length - limit} more. Use \`limit\` param or \`deps search\` to find specific symbols.`);
+            }
+            lines.push('');
+        }
+    }
+    else {
+        const syms = grouped[kind] ?? [];
+        lines.push(`## ${pluralize(kind)} (${syms.length})`);
+        lines.push('');
+        const shown = syms.slice(0, limit);
+        for (const sym of shown) {
+            lines.push(formatSymbolCompact(sym));
+        }
+        if (syms.length > limit) {
+            lines.push(`... and ${syms.length - limit} more. Use \`limit\` param to see more.`);
+        }
+        lines.push('');
+    }
+    lines.push(`Total: ${symbols.length} exported symbols`);
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────
+// deps search
+// ─────────────────────────────────────────
+export function formatSearchResults(results) {
+    if (results.length === 0) {
+        return 'No symbols found matching your query.';
+    }
+    const lines = [];
+    lines.push(`Found ${results.length} symbols:\n`);
+    for (const result of results) {
+        const matchIndicator = result.matchType === 'exact' ? '(exact)' :
+            result.matchType === 'prefix' ? '(prefix)' :
+                result.matchType === 'contains' ? '(contains)' : '(fuzzy)';
+        lines.push(`### ${result.symbol.name} ${matchIndicator}`);
+        lines.push(`- Kind: \`${result.symbol.kind}\``);
+        lines.push(`- Signature: \`${result.symbol.signature}\``);
+        if (result.symbol.jsdoc?.description) {
+            lines.push(`- ${truncate(result.symbol.jsdoc.description, 150)}`);
+        }
+        lines.push(`- File: ${result.symbol.file}:${result.symbol.line}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────
+// deps usage
+// ─────────────────────────────────────────
+export function formatSymbolUsage(symbol, importPaths) {
+    const lines = [];
+    lines.push(`# ${symbol.name}`);
+    lines.push('');
+    lines.push('## Signature');
+    lines.push('```typescript');
+    lines.push(symbol.signature);
+    lines.push('```');
+    lines.push('');
+    lines.push(`- **Kind**: ${symbol.kind}`);
+    lines.push(`- **File**: ${symbol.file}:${symbol.line}`);
+    lines.push(`- **Entry point**: ${symbol.entrypoint}`);
+    lines.push('');
+    if (importPaths.length > 0) {
+        lines.push('## Import');
+        for (const path of importPaths) {
+            lines.push('```typescript');
+            lines.push(`import { ${symbol.name} } from '${path}';`);
+            lines.push('```');
+        }
+        lines.push('');
+    }
+    if (symbol.jsdoc) {
+        if (symbol.jsdoc.description) {
+            lines.push('## Description');
+            lines.push(symbol.jsdoc.description);
+            lines.push('');
+        }
+        if (symbol.jsdoc.params && symbol.jsdoc.params.length > 0) {
+            lines.push('## Parameters');
+            for (const param of symbol.jsdoc.params) {
+                const desc = param.description ? ` - ${param.description}` : '';
+                lines.push(`- \`${param.name}\`${desc}`);
+            }
+            lines.push('');
+        }
+        if (symbol.jsdoc.returns) {
+            lines.push('## Returns');
+            lines.push(symbol.jsdoc.returns);
+            lines.push('');
+        }
+        if (symbol.jsdoc.deprecated) {
+            const msg = typeof symbol.jsdoc.deprecated === 'string'
+                ? `: ${symbol.jsdoc.deprecated}`
+                : '';
+            lines.push(`> **DEPRECATED**${msg}`);
+            lines.push('');
+        }
+        if (symbol.jsdoc.throws && symbol.jsdoc.throws.length > 0) {
+            lines.push('## Throws');
+            for (const t of symbol.jsdoc.throws) {
+                lines.push(`- ${t}`);
+            }
+            lines.push('');
+        }
+        if (symbol.jsdoc.examples && symbol.jsdoc.examples.length > 0) {
+            lines.push('## Examples');
+            for (const example of symbol.jsdoc.examples) {
+                lines.push('```typescript');
+                lines.push(example);
+                lines.push('```');
+                lines.push('');
+            }
+        }
+    }
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────
+// deps examples
+// ─────────────────────────────────────────
+export function formatExamples(examples) {
+    if (examples.length === 0) {
+        return 'No examples found.';
+    }
+    const lines = [];
+    lines.push(`# Examples (${examples.length} found)\n`);
+    for (let i = 0; i < examples.length; i++) {
+        const ex = examples[i];
+        const lang = ex.language ?? '';
+        const context = ex.context ? ` (${ex.context})` : '';
+        const source = ex.source === 'jsdoc' ? 'JSDoc' :
+            ex.source === 'readme' ? 'README' :
+                ex.source === 'examples-dir' ? 'examples/' : 'docs/';
+        lines.push(`## Example ${i + 1}${context} [${source}]`);
+        lines.push(`\`\`\`${lang}`);
+        lines.push(ex.code);
+        lines.push('```\n');
+    }
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────
+function formatSymbolCompact(sym) {
+    const jsdocHint = sym.jsdoc?.description
+        ? ` // ${truncate(sym.jsdoc.description, 80)}`
+        : '';
+    const deprecated = sym.jsdoc?.deprecated ? ' [DEPRECATED]' : '';
+    return `- \`${sym.name}\` (\`${sym.kind}\`)${deprecated}${jsdocHint}`;
+}
+function groupByKind(symbols) {
+    const groups = {};
+    for (const sym of symbols) {
+        if (!groups[sym.kind])
+            groups[sym.kind] = [];
+        groups[sym.kind].push(sym);
+    }
+    for (const key of Object.keys(groups)) {
+        groups[key].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    return groups;
+}
+function pluralize(kind) {
+    const map = {
+        function: 'Functions',
+        class: 'Classes',
+        interface: 'Interfaces',
+        type: 'Types',
+        enum: 'Enums',
+        variable: 'Variables',
+        constant: 'Constants',
+    };
+    return map[kind] ?? `${kind}s`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.substring(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=markdown-formatter.js.map

package/build/formatters/markdown-formatter.js.map

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

package/build/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * @justmpm/deps-consult -- MCP Server
+ *
+ * Consulta pacotes instalados no node_modules.
+ * Extrai API surfaces, tipos, documentação e exemplos de uso.
+ * Zero config, offline, funciona com qualquer pacote npm.
+ *
+ * Tools: deps_info, deps_api, deps_search, deps_usage, deps_examples
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/build/index.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+/**
+ * @justmpm/deps-consult -- MCP Server
+ *
+ * Consulta pacotes instalados no node_modules.
+ * Extrai API surfaces, tipos, documentação e exemplos de uso.
+ * Zero config, offline, funciona com qualquer pacote npm.
+ *
+ * Tools: deps_info, deps_api, deps_search, deps_usage, deps_examples
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { resolve } from 'node:path';
+import { DepsInfoInputSchema, DepsApiInputSchema, DepsSearchInputSchema, DepsUsageInputSchema, DepsExamplesInputSchema, } from './schemas/package-json.schema.js';
+import { getOrExtractPackage, searchSymbols, findSymbol, getExamples, resolveImportPaths, } from './pipeline.js';
+import { formatPackageInfo, formatApiSurface, formatSearchResults, formatSymbolUsage, formatExamples, } from './formatters/markdown-formatter.js';
+// ─────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────
+/** Normaliza kind do usuario (plural) para SymbolKind (singular) */
+const KIND_ALIASES = {
+    function: 'function',
+    functions: 'function',
+    class: 'class',
+    classes: 'class',
+    interface: 'interface',
+    interfaces: 'interface',
+    type: 'type',
+    types: 'type',
+    enum: 'enum',
+    enums: 'enum',
+    variable: 'variable',
+    variables: 'variable',
+    constant: 'constant',
+    constants: 'constant',
+};
+function normalizeKind(kind) {
+    return KIND_ALIASES[kind];
+}
+// ─────────────────────────────────────────
+// MCP Server Setup
+// ─────────────────────────────────────────
+const server = new McpServer({
+    name: 'deps-consult',
+    version: '1.0.0',
+});
+// ─────────────────────────────────────────
+// Tool: deps_info
+// ─────────────────────────────────────────
+server.tool('deps_info', 'Get overview of an installed npm package: version, description, entry points, dependencies, types availability, and disk size.', DepsInfoInputSchema, async ({ package: packageName, projectDir: rawProjectDir }) => {
+    try {
+        const projectDir = resolve(rawProjectDir ?? process.cwd());
+        const cached = await getOrExtractPackage(packageName, projectDir);
+        const output = formatPackageInfo(cached.meta);
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// ─────────────────────────────────────────
+// Tool: deps_api
+// ─────────────────────────────────────────
+server.tool('deps_api', 'Get the full API surface of an installed package: all exported functions, classes, interfaces, types, enums and variables with signatures.', DepsApiInputSchema, async ({ package: packageName, entrypoint, kind, limit: rawLimit }) => {
+    try {
+        const projectDir = resolve(process.cwd());
+        const cached = await getOrExtractPackage(packageName, projectDir);
+        let symbols = [];
+        if (entrypoint) {
+            const normalized = entrypoint.startsWith('.') ? entrypoint : `./${entrypoint}`;
+            const epSymbols = cached.symbols.get(normalized);
+            if (epSymbols) {
+                symbols = [...epSymbols];
+            }
+            else {
+                for (const syms of cached.symbols.values()) {
+                    symbols.push(...syms);
+                }
+            }
+        }
+        else {
+            const seen = new Set();
+            for (const syms of cached.symbols.values()) {
+                for (const sym of syms) {
+                    if (!seen.has(sym.name)) {
+                        seen.add(sym.name);
+                        symbols.push(sym);
+                    }
+                }
+            }
+        }
+        // Filtrar por kind
+        if (kind && kind !== 'all') {
+            const normalizedKind = normalizeKind(kind);
+            if (normalizedKind) {
+                symbols = symbols.filter(s => s.kind === normalizedKind);
+            }
+        }
+        const limit = rawLimit ?? 50;
+        const normalizedKindForFormat = kind && kind !== 'all' ? (normalizeKind(kind) ?? kind) : 'all';
+        const output = formatApiSurface(symbols, normalizedKindForFormat, limit);
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// ─────────────────────────────────────────
+// Tool: deps_search
+// ─────────────────────────────────────────
+server.tool('deps_search', 'Search for symbols in an installed package by name. Supports exact match, prefix (*), suffix (*), contains (*) and fuzzy matching.', DepsSearchInputSchema, async ({ package: packageName, query, entrypoint, kind }) => {
+    try {
+        const projectDir = resolve(process.cwd());
+        const cached = await getOrExtractPackage(packageName, projectDir);
+        const results = searchSymbols(cached, query, {
+            entrypoint,
+            kind: kind && kind !== 'all' ? normalizeKind(kind) : undefined,
+        });
+        const limited = results.slice(0, 30);
+        const output = formatSearchResults(limited);
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// ─────────────────────────────────────────
+// Tool: deps_usage
+// ─────────────────────────────────────────
+server.tool('deps_usage', 'Get detailed usage information for a specific symbol: full signature with types, JSDoc documentation, parameters, return type, examples, import paths, and related types.', DepsUsageInputSchema, async ({ package: packageName, symbol: symbolName, entrypoint }) => {
+    try {
+        const projectDir = resolve(process.cwd());
+        const cached = await getOrExtractPackage(packageName, projectDir);
+        const symbol = findSymbol(cached, symbolName, entrypoint);
+        if (!symbol) {
+            const results = searchSymbols(cached, symbolName, { entrypoint });
+            const best = results[0];
+            if (best && best.score > 0.5) {
+                const importPaths = resolveImportPaths(cached, best.symbol);
+                const output = formatSymbolUsage(best.symbol, importPaths);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Exact symbol '${symbolName}' not found. Showing best match:\n\n${output}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Symbol '${symbolName}' not found in '${packageName}'. Use deps_search to find the correct name.`,
+                    }],
+                isError: true,
+            };
+        }
+        const importPaths = resolveImportPaths(cached, symbol);
+        const output = formatSymbolUsage(symbol, importPaths);
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// ─────────────────────────────────────────
+// Tool: deps_examples
+// ─────────────────────────────────────────
+server.tool('deps_examples', 'Extract code examples from an installed package: JSDoc @example tags, /examples directory files, README code blocks, and /docs content.', DepsExamplesInputSchema, async ({ package: packageName, symbol: symbolName }) => {
+    try {
+        const projectDir = resolve(process.cwd());
+        const cached = await getOrExtractPackage(packageName, projectDir);
+        const examples = await getExamples(cached, symbolName);
+        if (examples.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: symbolName
+                            ? `No examples found for '${symbolName}' in '${packageName}'.`
+                            : `No examples found in '${packageName}'.`,
+                    }],
+            };
+        }
+        const output = formatExamples(examples);
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// ─────────────────────────────────────────
+// Start
+// ─────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[deps-consult] MCP server started (stdio)');
+}
+main().catch((error) => {
+    console.error('[deps-consult] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/pipeline.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pipeline de orquestração: conecta resolvers, extractors e cache.
+ * Uma função por tool que faz todo o fluxo end-to-end.
+ */
+import type { CachedPackage, ExtractedSymbol, SearchResult } from './types/index.js';
+import type { CodeExample } from './extractors/examples-extractor.js';
+/**
+ * Extrai e cacheia o pacote completo.
+ * Este é o ponto de entrada para todas as tools.
+ */
+export declare function getOrExtractPackage(packageName: string, projectDir: string): Promise<CachedPackage>;
+/**
+ * Busca símbolos em um pacote com scoring.
+ */
+export declare function searchSymbols(cached: CachedPackage, query: string, options?: {
+    entrypoint?: string;
+    kind?: string;
+}): SearchResult[];
+/**
+ * Encontra um símbolo exato pelo nome.
+ */
+export declare function findSymbol(cached: CachedPackage, symbolName: string, entrypoint?: string): ExtractedSymbol | undefined;
+/**
+ * Extrai exemplos para um pacote/símbolo.
+ */
+export declare function getExamples(cached: CachedPackage, symbolName?: string): Promise<ReadonlyArray<CodeExample>>;
+/**
+ * Resolve os import paths possíveis para um símbolo.
+ */
+export declare function resolveImportPaths(cached: CachedPackage, symbol: ExtractedSymbol): string[];
+//# sourceMappingURL=pipeline.d.ts.map

package/build/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAEf,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAStE;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CA6DxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,YAAY,EAAE,CAmEhB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,GAAG,SAAS,CAG7B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAQrC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,eAAe,GACtB,MAAM,EAAE,CAyBV"}