lsp-intelligence 0.1.0

package/dist/engine/LspEngine.js

@@ -0,0 +1,339 @@
+import { spawn, execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { createMessageConnection, StreamMessageReader, StreamMessageWriter, } from 'vscode-jsonrpc/node.js';
+import { DocumentManager } from './DocumentManager.js';
+import { pathToUri, uriToPath } from './positions.js';
+import { LspError, LspErrorCode, SKIP_DIRS, DEFAULT_TIMEOUTS } from './types.js';
+export class LspEngine {
+    connection = null;
+    process = null;
+    capabilities = null;
+    _ready;
+    _resolveReady;
+    _rejectReady;
+    docManager = new DocumentManager();
+    workspaceRoot;
+    gitAvailable = false;
+    constructor(workspaceRoot) {
+        this.workspaceRoot = workspaceRoot;
+        this._ready = new Promise((resolve, reject) => {
+            this._resolveReady = resolve;
+            this._rejectReady = reject;
+        });
+    }
+    async initialize() {
+        try {
+            // Check git availability
+            try {
+                execSync('git rev-parse --is-inside-work-tree', { cwd: this.workspaceRoot, stdio: 'pipe' });
+                this.gitAvailable = true;
+            }
+            catch {
+                this.gitAvailable = false;
+            }
+            // Spawn typescript-language-server — prefer bundled binary, fall back to global
+            const tslsBin = this.resolveBinary('typescript-language-server');
+            this.process = spawn(tslsBin, ['--stdio'], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                cwd: this.workspaceRoot,
+            });
+            if (!this.process.stdout || !this.process.stdin) {
+                throw new LspError(LspErrorCode.SERVER_CRASHED, 'Failed to spawn typescript-language-server');
+            }
+            this.process.stderr?.on('data', () => { }); // suppress stderr
+            this.process.on('exit', (code) => {
+                console.error(`[lsp-intelligence] TSServer exited with code ${code}`);
+                this.connection = null;
+            });
+            // Create JSON-RPC connection
+            this.connection = createMessageConnection(new StreamMessageReader(this.process.stdout), new StreamMessageWriter(this.process.stdin));
+            this.connection.listen();
+            // LSP initialize handshake
+            const result = await this.connection.sendRequest('initialize', {
+                processId: process.pid,
+                rootUri: pathToUri(this.workspaceRoot),
+                capabilities: {
+                    textDocument: {
+                        synchronization: { dynamicRegistration: false, didSave: true },
+                        hover: { contentFormat: ['markdown', 'plaintext'] },
+                        definition: {},
+                        typeDefinition: {},
+                        implementation: {},
+                        references: {},
+                        documentSymbol: { hierarchicalDocumentSymbolSupport: true },
+                        rename: { prepareSupport: true },
+                        publishDiagnostics: { relatedInformation: true },
+                        callHierarchy: {},
+                        completion: { completionItem: { snippetSupport: false } },
+                        codeAction: {},
+                    },
+                    workspace: {
+                        workspaceFolders: true,
+                        symbol: {},
+                    },
+                },
+                workspaceFolders: [{ uri: pathToUri(this.workspaceRoot), name: 'workspace' }],
+                initializationOptions: this.buildInitOptions(),
+            });
+            this.capabilities = result.capabilities;
+            this.connection.sendNotification('initialized', {});
+            // Handle diagnostics push
+            this.connection.onNotification('textDocument/publishDiagnostics', (params) => {
+                this.docManager.cacheDiagnostics(params.uri, params.diagnostics);
+            });
+            // Preopen all monorepo packages (non-blocking — resolve ready immediately after)
+            await this.preopenPackages();
+            // Resolve ready as soon as didOpen notifications are sent.
+            // TSServer indexes incrementally — queries retry if needed.
+            this._resolveReady();
+        }
+        catch (err) {
+            this._rejectReady(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+    }
+    /**
+     * Send an LSP request. Waits for engine to be ready first.
+     */
+    async request(method, params, timeoutMs) {
+        await this._ready;
+        if (!this.connection) {
+            throw new LspError(LspErrorCode.NOT_READY, 'LSP connection not available');
+        }
+        const timeout = timeoutMs ?? DEFAULT_TIMEOUTS.primitive;
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new LspError(LspErrorCode.TIMEOUT, `${method} timed out after ${timeout}ms`)), timeout));
+        return Promise.race([
+            this.connection.sendRequest(method, params),
+            timeoutPromise,
+        ]);
+    }
+    /**
+     * Ensure a file is open and return its URI + content.
+     */
+    async prepareFile(filePath) {
+        await this._ready;
+        if (!this.connection)
+            throw new LspError(LspErrorCode.NOT_READY, 'LSP connection not available');
+        const content = await this.docManager.ensureOpen(filePath, this.connection);
+        return { uri: pathToUri(filePath), content };
+    }
+    /**
+     * Resolve a symbol name to a file position using workspace/symbol.
+     */
+    async resolveSymbol(name, fileHint) {
+        await this._ready;
+        // Retry up to 5 times with short delays — index builds incrementally
+        let symbols = null;
+        for (let attempt = 0; attempt < 5; attempt++) {
+            symbols = await this.request('workspace/symbol', { query: name });
+            if (symbols && symbols.length > 0)
+                break;
+            if (attempt < 4)
+                await new Promise((r) => setTimeout(r, 300));
+        }
+        if (!symbols || symbols.length === 0) {
+            throw new LspError(LspErrorCode.SYMBOL_NOT_FOUND, `No symbol found matching "${name}"`, 'Try a more specific name or use file_path + line + column instead.');
+        }
+        // Priority: exact match > file hint match > first result
+        let best = symbols[0];
+        for (const sym of symbols) {
+            if (sym.name === name) {
+                if (fileHint && uriToPath(sym.location.uri).includes(fileHint)) {
+                    best = sym;
+                    break;
+                }
+                best = sym;
+            }
+        }
+        // workspace/symbol returns range.start at the declaration keyword (e.g. "export"),
+        // but hover/references need the cursor on the actual symbol name.
+        // Read the line and find the exact column of the symbol name.
+        const uri = best.location.uri;
+        let position = best.location.range.start;
+        try {
+            const filePath = uriToPath(uri);
+            if (this.connection) {
+                const content = await this.docManager.ensureOpen(filePath, this.connection);
+                const lines = content.split('\n');
+                const line = lines[position.line];
+                if (line) {
+                    const nameIndex = line.indexOf(best.name);
+                    if (nameIndex >= 0) {
+                        position = { line: position.line, character: nameIndex };
+                    }
+                }
+            }
+        }
+        catch { }
+        return { uri, position, name: best.name };
+    }
+    /**
+     * Discover monorepo packages and open one file per package.
+     */
+    async preopenPackages() {
+        const packageDirs = this.discoverWorkspacePackages();
+        if (packageDirs.length === 0)
+            return;
+        const openPromises = [];
+        for (const pkgDir of packageDirs) {
+            const filesToOpen = [];
+            // Prefer index.ts / index.tsx in src/ (main exports)
+            for (const indexFile of ['src/index.ts', 'src/index.tsx', 'index.ts', 'index.tsx']) {
+                const candidate = path.join(pkgDir, indexFile);
+                if (fs.existsSync(candidate)) {
+                    filesToOpen.push(candidate);
+                    break;
+                }
+            }
+            // Also open any first .ts file if no index found
+            if (filesToOpen.length === 0) {
+                const srcDir = path.join(pkgDir, 'src');
+                const searchDir = fs.existsSync(srcDir) ? srcDir : pkgDir;
+                const tsFile = this.findFirstTsFile(searchDir);
+                if (tsFile)
+                    filesToOpen.push(tsFile);
+            }
+            for (const tsFile of filesToOpen) {
+                if (this.connection) {
+                    openPromises.push(this.docManager.ensureOpen(tsFile, this.connection).then(() => { }));
+                }
+            }
+        }
+        await Promise.all(openPromises);
+        // Wait until TSServer has indexed at least one project (poll, max 15s)
+        const pollStart = Date.now();
+        while (Date.now() - pollStart < 15000) {
+            try {
+                const result = await this.connection.sendRequest('workspace/symbol', { query: 'a' });
+                if (Array.isArray(result) && result.length > 0)
+                    break;
+            }
+            catch { }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+    }
+    /**
+     * Discover workspace packages from any monorepo structure.
+     * Supports: packages/, apps/, libs/, pnpm-workspace.yaml, lerna.json, rush.json
+     */
+    discoverWorkspacePackages() {
+        const dirs = [];
+        // Common monorepo directory conventions
+        const conventionDirs = ['packages', 'apps', 'libs', 'modules', 'services'];
+        for (const dir of conventionDirs) {
+            const candidate = path.join(this.workspaceRoot, dir);
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+                for (const entry of fs.readdirSync(candidate)) {
+                    const pkgDir = path.join(candidate, entry);
+                    if (fs.statSync(pkgDir).isDirectory() && !entry.startsWith('.')) {
+                        dirs.push(pkgDir);
+                    }
+                }
+            }
+        }
+        // If no convention dirs found, check for workspace config files
+        if (dirs.length === 0) {
+            try {
+                // pnpm-workspace.yaml
+                const pnpmWs = path.join(this.workspaceRoot, 'pnpm-workspace.yaml');
+                if (fs.existsSync(pnpmWs)) {
+                    const content = fs.readFileSync(pnpmWs, 'utf-8');
+                    const globs = content.match(/- ['"]?([^'":\n]+)/g);
+                    if (globs) {
+                        for (const glob of globs) {
+                            const pattern = glob.replace(/- ['"]?/, '').replace(/['"]$/, '').replace('/*', '');
+                            const dir = path.join(this.workspaceRoot, pattern);
+                            if (fs.existsSync(dir) && fs.statSync(dir).isDirectory()) {
+                                for (const entry of fs.readdirSync(dir)) {
+                                    const pkgDir = path.join(dir, entry);
+                                    if (fs.statSync(pkgDir).isDirectory() && !entry.startsWith('.')) {
+                                        dirs.push(pkgDir);
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+                // package.json workspaces field
+                const rootPkg = path.join(this.workspaceRoot, 'package.json');
+                if (dirs.length === 0 && fs.existsSync(rootPkg)) {
+                    const pkg = JSON.parse(fs.readFileSync(rootPkg, 'utf-8'));
+                    const workspaces = Array.isArray(pkg.workspaces)
+                        ? pkg.workspaces
+                        : pkg.workspaces?.packages ?? [];
+                    for (const ws of workspaces) {
+                        const pattern = ws.replace('/*', '');
+                        const dir = path.join(this.workspaceRoot, pattern);
+                        if (fs.existsSync(dir) && fs.statSync(dir).isDirectory()) {
+                            for (const entry of fs.readdirSync(dir)) {
+                                const pkgDir = path.join(dir, entry);
+                                if (fs.statSync(pkgDir).isDirectory() && !entry.startsWith('.')) {
+                                    dirs.push(pkgDir);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            catch { }
+        }
+        return [...new Set(dirs)];
+    }
+    /**
+     * Build initializationOptions for typescript-language-server.
+     * Points tsserver.path to the consumer's TypeScript if available.
+     */
+    buildInitOptions() {
+        const consumerTsPath = path.join(this.workspaceRoot, 'node_modules', 'typescript', 'lib');
+        if (fs.existsSync(consumerTsPath)) {
+            return { tsserver: { path: consumerTsPath } };
+        }
+        return {};
+    }
+    /**
+     * Resolve a binary — check bundled node_modules/.bin first, then global PATH.
+     */
+    resolveBinary(name) {
+        // Check our own node_modules/.bin (bundled dependency)
+        const localBin = path.resolve(import.meta.dirname, '..', '..', 'node_modules', '.bin', name);
+        if (fs.existsSync(localBin))
+            return localBin;
+        // Fall back to global PATH
+        return name;
+    }
+    findFirstTsFile(dir, depth = 0) {
+        if (depth > 4)
+            return null;
+        try {
+            for (const entry of fs.readdirSync(dir)) {
+                if (SKIP_DIRS.has(entry))
+                    continue;
+                const full = path.join(dir, entry);
+                const stat = fs.statSync(full);
+                if (stat.isDirectory()) {
+                    const found = this.findFirstTsFile(full, depth + 1);
+                    if (found)
+                        return found;
+                }
+                else if (entry.endsWith('.ts') || entry.endsWith('.tsx')) {
+                    return full;
+                }
+            }
+        }
+        catch { }
+        return null;
+    }
+    async shutdown() {
+        if (this.connection) {
+            try {
+                await this.connection.sendRequest('shutdown');
+                this.connection.sendNotification('exit');
+            }
+            catch { }
+            this.connection.dispose();
+        }
+        this.process?.kill();
+    }
+}
+//# sourceMappingURL=LspEngine.js.map

package/dist/engine/LspEngine.js.map

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

package/dist/engine/positions.d.ts

@@ -0,0 +1,31 @@
+import type { Position } from 'vscode-languageserver-protocol';
+/**
+ * Convert 1-indexed line/column (Claude-facing) to 0-indexed LSP Position.
+ */
+export declare function toPosition(line1: number, col1: number, content?: string): Position;
+/**
+ * Convert 0-indexed LSP Position to 1-indexed (Claude-facing).
+ */
+export declare function fromPosition(pos: Position): {
+    line: number;
+    column: number;
+};
+/**
+ * Convert an absolute file path to a file:// URI.
+ */
+export declare function pathToUri(filePath: string): string;
+/**
+ * Convert a file:// URI to an absolute file path.
+ */
+export declare function uriToPath(uri: string): string;
+/**
+ * Get the containing package name from a file path.
+ * Works with any monorepo layout: packages/, apps/, libs/, modules/, services/
+ * E.g., "/repo/packages/core/src/foo.ts" → "core"
+ * E.g., "/repo/apps/web/src/foo.ts" → "web"
+ */
+export declare function getPackageName(filePath: string): string | null;
+/**
+ * Shorten a file path relative to the workspace root.
+ */
+export declare function relativePath(filePath: string, workspaceRoot: string): string;

package/dist/engine/positions.js

@@ -0,0 +1,55 @@
+import { LspError, LspErrorCode } from './types.js';
+/**
+ * Convert 1-indexed line/column (Claude-facing) to 0-indexed LSP Position.
+ */
+export function toPosition(line1, col1, content) {
+    const line = line1 - 1;
+    const character = col1 - 1;
+    if (line < 0 || character < 0) {
+        throw new LspError(LspErrorCode.FILE_NOT_FOUND, `Invalid position: line ${line1}, column ${col1} (must be >= 1)`);
+    }
+    return { line, character };
+}
+/**
+ * Convert 0-indexed LSP Position to 1-indexed (Claude-facing).
+ */
+export function fromPosition(pos) {
+    return { line: pos.line + 1, column: pos.character + 1 };
+}
+/**
+ * Convert an absolute file path to a file:// URI.
+ */
+export function pathToUri(filePath) {
+    if (filePath.startsWith('file://'))
+        return filePath;
+    return `file://${filePath}`;
+}
+/**
+ * Convert a file:// URI to an absolute file path.
+ */
+export function uriToPath(uri) {
+    if (uri.startsWith('file://'))
+        return decodeURIComponent(uri.slice(7));
+    return uri;
+}
+/**
+ * Get the containing package name from a file path.
+ * Works with any monorepo layout: packages/, apps/, libs/, modules/, services/
+ * E.g., "/repo/packages/core/src/foo.ts" → "core"
+ * E.g., "/repo/apps/web/src/foo.ts" → "web"
+ */
+export function getPackageName(filePath) {
+    const match = filePath.match(/\/(packages|apps|libs|modules|services)\/([^/]+)\//);
+    return match ? match[2] : null;
+}
+/**
+ * Shorten a file path relative to the workspace root.
+ */
+export function relativePath(filePath, workspaceRoot) {
+    const resolved = uriToPath(filePath);
+    if (resolved.startsWith(workspaceRoot)) {
+        return resolved.slice(workspaceRoot.length + 1);
+    }
+    return resolved;
+}
+//# sourceMappingURL=positions.js.map

package/dist/engine/positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.js","sourceRoot":"","sources":["../../src/engine/positions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,IAAY,EAAE,OAAgB;IACtE,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC;IAC3B,IAAI,IAAI,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,cAAc,EAC3B,0BAA0B,KAAK,YAAY,IAAI,iBAAiB,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAa;IACxC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpD,OAAO,UAAU,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,aAAqB;IAClE,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/engine/types.d.ts

@@ -0,0 +1,61 @@
+import type { Diagnostic, Location, Position } from 'vscode-languageserver-protocol';
+export declare enum LspErrorCode {
+    NOT_READY = "NOT_READY",
+    TIMEOUT = "TIMEOUT",
+    SYMBOL_NOT_FOUND = "SYMBOL_NOT_FOUND",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    CAPABILITY_MISSING = "CAPABILITY_MISSING",
+    SERVER_CRASHED = "SERVER_CRASHED",
+    GIT_UNAVAILABLE = "GIT_UNAVAILABLE"
+}
+export declare class LspError extends Error {
+    code: LspErrorCode;
+    suggestion?: string | undefined;
+    constructor(code: LspErrorCode, message: string, suggestion?: string | undefined);
+}
+export interface SymbolInput {
+    input_type: 'symbol';
+    symbol: string;
+    file_path?: string;
+}
+export interface PositionInput {
+    input_type: 'position';
+    file_path: string;
+    line: number;
+    column: number;
+}
+export type SymbolOrPosition = SymbolInput | PositionInput;
+export type Verbosity = 'summary' | 'normal' | 'detailed';
+export interface ResolvedLocation {
+    uri: string;
+    position: Position;
+    name?: string;
+}
+export interface ReferenceResult {
+    uri: string;
+    range: {
+        start: Position;
+        end: Position;
+    };
+    kind?: 'definition' | 'import' | 'call' | 'type_annotation' | 're_export' | 'other';
+    context?: string;
+}
+export interface ImpactNode {
+    uri: string;
+    position: Position;
+    name: string;
+    depth: number;
+    references: Location[];
+    isTypeAlias: boolean;
+}
+export interface DiagnosticEntry {
+    uri: string;
+    diagnostics: Diagnostic[];
+}
+export declare const SKIP_DIRS: Set<string>;
+export declare const DEFAULT_TIMEOUTS: {
+    readonly primitive: 10000;
+    readonly composite: 20000;
+    readonly context: 30000;
+    readonly live: 10000;
+};

package/dist/engine/types.js

@@ -0,0 +1,33 @@
+// --- Error types ---
+export var LspErrorCode;
+(function (LspErrorCode) {
+    LspErrorCode["NOT_READY"] = "NOT_READY";
+    LspErrorCode["TIMEOUT"] = "TIMEOUT";
+    LspErrorCode["SYMBOL_NOT_FOUND"] = "SYMBOL_NOT_FOUND";
+    LspErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    LspErrorCode["CAPABILITY_MISSING"] = "CAPABILITY_MISSING";
+    LspErrorCode["SERVER_CRASHED"] = "SERVER_CRASHED";
+    LspErrorCode["GIT_UNAVAILABLE"] = "GIT_UNAVAILABLE";
+})(LspErrorCode || (LspErrorCode = {}));
+export class LspError extends Error {
+    code;
+    suggestion;
+    constructor(code, message, suggestion) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.name = 'LspError';
+    }
+}
+// --- Constants ---
+export const SKIP_DIRS = new Set([
+    'node_modules', 'dist', 'es', '.cache', '.git',
+    '__pycache__', '.next', '.turbo', 'coverage',
+]);
+export const DEFAULT_TIMEOUTS = {
+    primitive: 10_000,
+    composite: 20_000,
+    context: 30_000,
+    live: 10_000,
+};
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAEA,sBAAsB;AAEtB,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACtB,uCAAuB,CAAA;IACvB,mCAAmB,CAAA;IACnB,qDAAqC,CAAA;IACrC,iDAAiC,CAAA;IACjC,yDAAyC,CAAA;IACzC,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;AACrC,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IAExB;IAEA;IAHT,YACS,IAAkB,EACzB,OAAe,EACR,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAc;QAElB,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAkDD,oBAAoB;AAEpB,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM;IAC9C,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/format/markdown.d.ts

@@ -0,0 +1,5 @@
+import type { Location, Hover } from 'vscode-languageserver-protocol';
+import type { Verbosity } from '../engine/types.js';
+export declare function formatReferences(locations: Location[] | null, workspaceRoot: string, verbosity?: Verbosity): string;
+export declare function formatDefinitions(locations: Location | Location[] | null, workspaceRoot: string): string;
+export declare function formatHover(hover: Hover | null): string;

package/dist/format/markdown.js

@@ -0,0 +1,90 @@
+import { fromPosition, uriToPath, relativePath } from '../engine/positions.js';
+import * as fs from 'fs';
+export function formatReferences(locations, workspaceRoot, verbosity = 'normal') {
+    if (!locations || locations.length === 0)
+        return 'No references found.';
+    // Group by file
+    const byFile = new Map();
+    for (const loc of locations) {
+        const file = uriToPath(loc.uri);
+        const existing = byFile.get(file) ?? [];
+        existing.push(loc);
+        byFile.set(file, existing);
+    }
+    const totalFiles = byFile.size;
+    const totalRefs = locations.length;
+    const summary = `${totalRefs} references across ${totalFiles} files`;
+    if (verbosity === 'summary')
+        return summary;
+    const lines = [`# References\n\n${summary}\n`];
+    for (const [file, refs] of [...byFile.entries()].sort()) {
+        const rel = relativePath(file, workspaceRoot);
+        lines.push(`## ${rel} (${refs.length})\n`);
+        for (const ref of refs.sort((a, b) => a.range.start.line - b.range.start.line)) {
+            const pos = fromPosition(ref.range.start);
+            if (verbosity === 'detailed') {
+                const context = getContextLines(file, ref.range.start.line, 1);
+                lines.push(`### L${pos.line}\n\`\`\`\n${context}\n\`\`\`\n`);
+            }
+            else {
+                const context = getLineContent(file, ref.range.start.line);
+                lines.push(`- L${pos.line}: \`${context.trim()}\``);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function formatDefinitions(locations, workspaceRoot) {
+    if (!locations)
+        return 'No definition found.';
+    const locs = Array.isArray(locations) ? locations : [locations];
+    if (locs.length === 0)
+        return 'No definition found.';
+    const lines = ['# Definition\n'];
+    for (const loc of locs) {
+        const rel = relativePath(uriToPath(loc.uri), workspaceRoot);
+        const pos = fromPosition(loc.range.start);
+        const context = getContextLines(uriToPath(loc.uri), loc.range.start.line, 2);
+        lines.push(`**${rel}:${pos.line}**\n\`\`\`\n${context}\n\`\`\`\n`);
+    }
+    return lines.join('\n');
+}
+export function formatHover(hover) {
+    if (!hover)
+        return 'No hover information available.';
+    const contents = hover.contents;
+    if (typeof contents === 'string')
+        return contents;
+    if ('kind' in contents)
+        return contents.value;
+    if ('language' in contents)
+        return `\`\`\`${contents.language}\n${contents.value}\n\`\`\``;
+    return String(contents);
+}
+function getLineContent(filePath, line0) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        return lines[line0] ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+function getContextLines(filePath, line0, context) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const start = Math.max(0, line0 - context);
+        const end = Math.min(lines.length - 1, line0 + context);
+        return lines
+            .slice(start, end + 1)
+            .map((l, i) => `${start + i + 1}| ${l}`)
+            .join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/format/markdown.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};