@lsproxy/cli 0.3.0

package/dist/build-commands.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import type { ServerCapabilities } from '@lspeasy/core';
+import type { RefactorSession } from './session.js';
+import type { GlobalFlags } from './io.js';
+export declare function buildCommandTree(program: Command, capabilities: ServerCapabilities, session: RefactorSession, flags: GlobalFlags): void;
+//# sourceMappingURL=build-commands.d.ts.map

package/dist/build-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-commands.d.ts","sourceRoot":"","sources":["../src/build-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA0D3C,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,WAAW,GACjB,IAAI,CA4DN"}

package/dist/build-commands.js

@@ -0,0 +1,111 @@
+import { Command } from 'commander';
+import { LSPSchemas, getSchemaForMethod, getCapabilityForRequestMethod } from '@lspeasy/core';
+import { zodToCommander, printAppliedChanges } from './zod-to-commander.js';
+import { applyWorkspaceEdit, planWorkspaceEdit } from './apply.js';
+function getNestedValue(obj, path) {
+    return path
+        .split('.')
+        .reduce((acc, key) => acc != null && typeof acc === 'object' ? acc[key] : undefined, obj);
+}
+function capabilityObject(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+function stringArray(value) {
+    return Array.isArray(value) && value.length > 0 ? value : null;
+}
+/**
+ * Enrich subcommand help text with runtime-discovered capability metadata.
+ * Resolves the server capability provider for the method, then scans its
+ * string and string-array fields — booleans and nested objects are skipped.
+ * Works generically for any LSP method; no per-method hardcoding required.
+ */
+function enrichCommandFromCapabilities(method, cmd, capabilities) {
+    const capPath = getCapabilityForRequestMethod(method);
+    if (capPath === 'alwaysOn')
+        return;
+    const obj = capabilityObject(getNestedValue(capabilities, capPath));
+    if (!obj)
+        return;
+    const lines = [];
+    for (const [key, val] of Object.entries(obj)) {
+        const arr = stringArray(val);
+        if (arr) {
+            lines.push(`${key}: ${arr.map((v) => JSON.stringify(v)).join('  ')}`);
+        }
+        else if (typeof val === 'string' && val.length > 0) {
+            lines.push(`${key}: ${JSON.stringify(val)}`);
+        }
+    }
+    if (lines.length)
+        cmd.addHelpText('after', `\nCapability options:\n  ${lines.join('\n  ')}`);
+}
+// Some methods share a top-level capability path with sibling methods, so the
+// top-level check alone is insufficient. Map those methods to a more specific
+// sub-path that must also be truthy before exposing the command.
+// e.g. semanticTokens/full shares 'semanticTokensProvider' with range/delta,
+// but requires 'semanticTokensProvider.full' to actually be supported.
+const CAPABILITY_REFINEMENTS = {
+    'textDocument/semanticTokens/full': 'semanticTokensProvider.full'
+};
+export function buildCommandTree(program, capabilities, session, flags) {
+    for (const method of Object.keys(LSPSchemas)) {
+        const schema = getSchemaForMethod(method);
+        if (!schema)
+            continue;
+        const capPath = getCapabilityForRequestMethod(method);
+        if (capPath === 'alwaysOn')
+            continue;
+        if (!getNestedValue(capabilities, capPath))
+            continue;
+        const refinedCapPath = CAPABILITY_REFINEMENTS[method];
+        if (refinedCapPath && !getNestedValue(capabilities, refinedCapPath))
+            continue;
+        const parts = method.split('/');
+        if (parts.length < 2)
+            continue;
+        const [namespace] = parts;
+        let nsCmd = program.commands.find((c) => c.name() === namespace);
+        if (!nsCmd) {
+            nsCmd = new Command(namespace).description(`${namespace} operations`);
+            program.addCommand(nsCmd);
+        }
+        const subCmd = zodToCommander(method, schema, session, flags);
+        enrichCommandFromCapabilities(method, subCmd, capabilities);
+        nsCmd.addCommand(subCmd);
+    }
+    program
+        .command('call <method>')
+        .description('Send any LSP request by method name with raw JSON params')
+        .option('--params <json>', 'LSP params as JSON')
+        .action(async (method, opts) => {
+        try {
+            const params = opts.params ? JSON.parse(opts.params) : {};
+            const result = await session.lsp.sendRequest(method, params);
+            const capturedEdits = session.takeCapturedEdits();
+            if (capturedEdits.length > 0) {
+                const guard = {
+                    root: flags.root,
+                    allowOutsideRoot: flags.allowOutsideRoot
+                };
+                const allChanges = capturedEdits.flatMap((edit) => flags.dryRun ? planWorkspaceEdit(edit, guard) : applyWorkspaceEdit(edit, guard));
+                printAppliedChanges(allChanges, method, flags.dryRun, flags.json);
+            }
+            else if (flags.json) {
+                process.stdout.write(JSON.stringify({ ok: true, method, result }) + '\n');
+            }
+            else {
+                process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            }
+        }
+        catch (err) {
+            if (flags.json) {
+                process.stdout.write(JSON.stringify({ ok: false, error: String(err) }) + '\n');
+            }
+            else {
+                process.stderr.write(`error: ${String(err)}\n`);
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=build-commands.js.map

package/dist/build-commands.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * lspeasy CLI entry point.
+ *
+ * Two-pass parse: util.parseArgs extracts global flags first (no Commander),
+ * then the CLI connects to the server, reads capabilities, builds a
+ * namespace/subcommand Commander tree, and hands process.argv back to
+ * Commander for final dispatch.
+ */
+import { type GlobalFlags } from './io.js';
+/** Parsed raw flag values from the first pass. */
+export type ParsedOptionValues = {
+    server?: string;
+    root?: string;
+    'dry-run'?: boolean;
+    json?: boolean;
+    wait?: string;
+    verbose?: boolean;
+    'allow-outside-root'?: boolean;
+    'no-proxy'?: boolean;
+};
+/**
+ * Validate raw flag values and project them onto {@link GlobalFlags}.
+ *
+ * `--wait` must parse to a finite, non-negative number; a typo like
+ * `--wait abc` would otherwise become NaN, which setTimeout coerces to 0,
+ * silently skipping the index wait refactor requests depend on.
+ */
+export declare function buildFlags(values: ParsedOptionValues): GlobalFlags;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AASH,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAwCjE,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAiBlE"}

package/dist/cli.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+/**
+ * lspeasy CLI entry point.
+ *
+ * Two-pass parse: util.parseArgs extracts global flags first (no Commander),
+ * then the CLI connects to the server, reads capabilities, builds a
+ * namespace/subcommand Commander tree, and hands process.argv back to
+ * Commander for final dispatch.
+ */
+import { parseArgs } from 'node:util';
+import { argv, exit } from 'node:process';
+import { extname } from 'node:path';
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { fail, resolvePathArg } from './io.js';
+import { discoverServer } from '@lspeasy/core';
+import { RefactorSession } from './session.js';
+import { connectViaProxy } from './connect.js';
+import { buildCommandTree } from './build-commands.js';
+const STATIC_HELP = `lspeasy — LSP-driven CLI
+
+Usage:
+  lspeasy <namespace> <command> [args]
+  lspeasy call <method> --params <json>
+
+Available commands depend on the connected server's advertised capabilities.
+Run with a file argument to see available commands for that language:
+  lspeasy textDocument hover --help src/foo.ts
+
+Global flags:
+  --server <cmd>        LSP server launch command (overrides lsp.json discovery)
+  --root <dir>          Project root (default: cwd)
+  --dry-run             Print changes; do not write
+  --json                Machine-readable JSON on stdout; diagnostics to stderr
+  --wait <ms>           Server index wait in ms (default: 15000)
+  --verbose             Progress logging to stderr
+  --allow-outside-root  Allow file paths outside --root
+  --no-proxy            Bypass proxy daemon; connect directly to language server
+  -h, --help            Show this help
+`;
+const GLOBAL_OPTION_CONFIG = {
+    server: { type: 'string' },
+    root: { type: 'string' },
+    'dry-run': { type: 'boolean', default: false },
+    json: { type: 'boolean', default: false },
+    wait: { type: 'string', default: '15000' },
+    verbose: { type: 'boolean', default: false },
+    'allow-outside-root': { type: 'boolean', default: false },
+    'no-proxy': { type: 'boolean', default: false },
+    help: { type: 'boolean', short: 'h', default: false }
+};
+/**
+ * Validate raw flag values and project them onto {@link GlobalFlags}.
+ *
+ * `--wait` must parse to a finite, non-negative number; a typo like
+ * `--wait abc` would otherwise become NaN, which setTimeout coerces to 0,
+ * silently skipping the index wait refactor requests depend on.
+ */
+export function buildFlags(values) {
+    const json = values.json === true;
+    const waitMs = Number(values.wait ?? '15000');
+    if (!Number.isFinite(waitMs) || waitMs < 0) {
+        fail(`--wait must be a non-negative number of milliseconds, got "${values.wait}"`, json);
+    }
+    return {
+        server: values.server ?? '',
+        root: values.root ?? process.cwd(),
+        dryRun: values['dry-run'] === true,
+        json,
+        verbose: values.verbose === true,
+        waitMs,
+        allowOutsideRoot: values['allow-outside-root'] === true,
+        noProxy: values['no-proxy'] === true,
+        overwrite: false // move-file removed; the flag is kept in GlobalFlags for io.ts compatibility
+    };
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        args: argv.slice(2),
+        options: GLOBAL_OPTION_CONFIG,
+        allowPositionals: true,
+        strict: false
+    });
+    if (!positionals.length) {
+        process.stdout.write(STATIC_HELP);
+        exit(0);
+    }
+    const flags = buildFlags(values);
+    let serverCommand;
+    let languageId = 'plaintext';
+    // positionals[0] = namespace, positionals[1] = method/command.
+    // The source file can only appear at positionals[2] (the first subcommand
+    // argument). A value is file-like only when it has an extension AND is not
+    // a JSON literal (--params values that parseArgs left in positionals).
+    // workspace/* methods (e.g. workspace/symbol) take a query string as their
+    // first argument, not a file — skip file detection for that namespace to avoid
+    // treating dotted identifiers like React.Component as file paths.
+    const isFileLike = (p) => extname(p) !== '' && !p.startsWith('{') && !p.startsWith('[') && !p.startsWith('"');
+    const firstSubArg = positionals[2];
+    const subArgFile = positionals[0] !== 'workspace' && firstSubArg !== undefined && isFileLike(firstSubArg)
+        ? firstSubArg
+        : undefined;
+    if (flags.server) {
+        serverCommand = flags.server;
+        // Infer languageId from the file extension when --server bypasses discovery.
+        if (subArgFile) {
+            const ext = extname(subArgFile);
+            const discovered = discoverServer(flags.root, ext);
+            if (discovered)
+                languageId = discovered.languageId;
+        }
+    }
+    else {
+        const ext = subArgFile ? extname(subArgFile) : '';
+        if (!ext) {
+            // No file argument — try lsp.json discovery with a wildcard lookup so
+            // file-less commands (e.g. workspace/symbol) can still find a server.
+            const discovered = discoverServer(flags.root, '');
+            if (discovered) {
+                serverCommand = discovered.serverCommand;
+                languageId = discovered.languageId;
+            }
+            else {
+                fail('Cannot determine language: pass a file argument or use --server <cmd>.', flags.json);
+            }
+        }
+        else {
+            const discovered = discoverServer(flags.root, ext);
+            if (!discovered) {
+                fail(`No LSP server configured for ${ext} files.\n` +
+                    'Add an lsp.json to your project (or ~/.claude/lsp.json) or use --server <cmd>.\n' +
+                    'Format: { "lspServers": { "lang": { "command": "...", "args": [...], "fileExtensions": { ".ext": "languageId" } } } }', flags.json);
+            }
+            serverCommand = discovered.serverCommand;
+            languageId = discovered.languageId;
+        }
+    }
+    let session;
+    if (flags.noProxy || !!flags.server || !serverCommand) {
+        session = new RefactorSession({
+            serverCommand,
+            languageId,
+            root: flags.root,
+            indexWaitMs: flags.waitMs,
+            verbose: flags.verbose
+        });
+        await session.start();
+    }
+    else {
+        session = await connectViaProxy({
+            root: flags.root,
+            languageId,
+            indexWaitMs: flags.waitMs,
+            verbose: flags.verbose
+        });
+    }
+    try {
+        if (subArgFile && !values.help) {
+            const absPath = resolvePathArg(subArgFile, flags);
+            await session.open(absPath);
+        }
+        const program = new Command('lspeasy');
+        // Declare global options so Commander does not reject them in pass 2
+        program
+            .option('--server <cmd>')
+            .option('--root <dir>')
+            .option('--dry-run')
+            .option('--json')
+            .option('--wait <ms>')
+            .option('--verbose')
+            .option('--allow-outside-root')
+            .option('--no-proxy');
+        buildCommandTree(program, session.capabilities, session, flags);
+        await program.parseAsync(argv);
+    }
+    finally {
+        await session.stop();
+    }
+}
+/**
+ * True when this module is the process entry point (vs. imported by a test).
+ *
+ * Compares resolved real paths of import.meta.url and argv[1]. The bin
+ * (lspeasy) is installed as a symlink to dist/cli.js, so argv[1] is the
+ * symlink path while import.meta.url is Node's realpath — a plain compare
+ * would mismatch and never run main(). realpathSync on both sides makes the
+ * symlinked-bin and direct-invocation cases agree.
+ */
+function isEntryPoint() {
+    const entry = argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(entry);
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntryPoint()) {
+    main().catch((err) => {
+        process.stderr.write(`fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+        exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/move-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `lspeasy move-file <oldPath> <newPath>`
+ *
+ * Asks the server for importer path updates via `workspace/willRenameFiles`,
+ * applies them, then physically moves the file. Uses `git mv` when the file is
+ * tracked (so history follows), falling back to a plain rename.
+ */
+import { type GlobalFlags } from '../io.js';
+export declare function runMoveFile(args: {
+    oldPath: string;
+    newPath: string;
+}, flags: GlobalFlags): Promise<void>;
+//# sourceMappingURL=move-file.d.ts.map

package/dist/commands/move-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-file.d.ts","sourceRoot":"","sources":["../../src/commands/move-file.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAgC9E,wBAAsB,WAAW,CAC/B,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1C,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/commands/move-file.js

@@ -0,0 +1,84 @@
+/**
+ * `lspeasy move-file <oldPath> <newPath>`
+ *
+ * Asks the server for importer path updates via `workspace/willRenameFiles`,
+ * applies them, then physically moves the file. Uses `git mv` when the file is
+ * tracked (so history follows), falling back to a plain rename.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, renameSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { applyWorkspaceEdit, planWorkspaceEdit, stripResourceOps } from '../apply.js';
+import { emitResult, fail, resolvePathArg } from '../io.js';
+import { RefactorSession } from '../session.js';
+function isGitTracked(root, path) {
+    try {
+        execFileSync('git', ['ls-files', '--error-unmatch', path], { cwd: root, stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function physicallyMove(root, from, to, dryRun, overwrite) {
+    if (!dryRun) {
+        mkdirSync(dirname(to), { recursive: true });
+        if (isGitTracked(root, from)) {
+            // `git mv` refuses an existing destination; `-f` is required to clobber.
+            const gitArgs = overwrite ? ['mv', '-f', from, to] : ['mv', from, to];
+            execFileSync('git', gitArgs, { cwd: root });
+        }
+        else {
+            renameSync(from, to);
+        }
+    }
+    return { kind: 'rename', path: from, toPath: to };
+}
+export async function runMoveFile(args, flags) {
+    const from = resolvePathArg(args.oldPath, flags);
+    const to = resolvePathArg(args.newPath, flags);
+    if (!existsSync(from))
+        fail(`source file not found: ${from}`, flags.json);
+    // Refuse to clobber an existing destination unless --overwrite was given.
+    // `renameSync` (the untracked-file path) silently destroys the destination on
+    // POSIX, and `git mv` (without -f) refuses — so guard up-front, before
+    // spawning the server, so dry-run predicts the refusal too.
+    if (existsSync(to) && !flags.overwrite) {
+        fail(`destination already exists: ${to} (pass --overwrite to replace)`, flags.json);
+    }
+    const session = new RefactorSession({
+        serverCommand: flags.server,
+        root: flags.root,
+        indexWaitMs: flags.waitMs,
+        verbose: flags.verbose
+    });
+    try {
+        await session.start();
+        await session.openAndWait(from);
+        const edit = await session.requestWithRetry(() => session.lsp.sendRequest('workspace/willRenameFiles', {
+            files: [{ oldUri: pathToFileURL(from).href, newUri: pathToFileURL(to).href }]
+        }));
+        // A null edit just means no importers needed updating — still do the move.
+        // Strip ONLY the rename the server folded in that duplicates our physical
+        // move below (so `git mv` history is preserved); applying that rename here
+        // too would double-move and break a re-run with "source not found". Other
+        // resource ops the server emits (e.g. a `create shim.ts`) are preserved.
+        const importerEdit = edit ? stripResourceOps(edit, { from, to }) : undefined;
+        // Validate the SERVER-RETURNED edit against --root before applying it.
+        const guard = { root: flags.root, allowOutsideRoot: flags.allowOutsideRoot };
+        const importerChanges = importerEdit
+            ? flags.dryRun
+                ? planWorkspaceEdit(importerEdit, guard)
+                : applyWorkspaceEdit(importerEdit, guard)
+            : [];
+        const moveChange = physicallyMove(flags.root, from, to, flags.dryRun, flags.overwrite);
+        emitResult('move-file', [...importerChanges, moveChange], flags, {
+            importerFilesUpdated: importerChanges.length
+        });
+    }
+    finally {
+        await session.stop();
+    }
+}
+//# sourceMappingURL=move-file.js.map

package/dist/commands/move-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-file.js","sourceRoot":"","sources":["../../src/commands/move-file.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAoB,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,SAAS,YAAY,CAAC,IAAY,EAAE,IAAY;IAC9C,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,IAAY,EACZ,IAAY,EACZ,EAAU,EACV,MAAe,EACf,SAAkB;IAElB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC7B,yEAAyE;YACzE,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YACtE,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAA0C,EAC1C,KAAkB;IAElB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,0BAA0B,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1E,0EAA0E;IAC1E,8EAA8E;IAC9E,uEAAuE;IACvE,4DAA4D;IAC5D,IAAI,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC,+BAA+B,EAAE,gCAAgC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;QAClC,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CACzC,GAAG,EAAE,CACH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,2BAA2B,EAAE;YACnD,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC9E,CAAkC,CACtC,CAAC;QAEF,2EAA2E;QAC3E,0EAA0E;QAC1E,2EAA2E;QAC3E,0EAA0E;QAC1E,yEAAyE;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,uEAAuE;QACvE,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC7E,MAAM,eAAe,GAAG,YAAY;YAClC,CAAC,CAAC,KAAK,CAAC,MAAM;gBACZ,CAAC,CAAC,iBAAiB,CAAC,YAAY,EAAE,KAAK,CAAC;gBACxC,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC;YAC3C,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAEvF,UAAU,CAAC,WAAW,EAAE,CAAC,GAAG,eAAe,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE;YAC/D,oBAAoB,EAAE,eAAe,CAAC,MAAM;SAC7C,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/move-symbol.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `lspeasy move-symbol <file> <line:col> <targetFile>`
+ *
+ * Moves the symbol at the given position into `targetFile`, updating all
+ * importers. Driven by `textDocument/codeAction` (kind `refactor.move`).
+ *
+ * Two server shapes are supported:
+ *  1. The code action (or its `codeAction/resolve`) returns a `WorkspaceEdit`
+ *     directly — applied as-is.
+ *  2. The action carries a `command`. We execute it via
+ *     `workspace/executeCommand`; many servers (notably
+ *     typescript-language-server's `_typescript.applyRefactoring`) then push
+ *     the edit back through a `workspace/applyEdit` request, which the session
+ *     captures. For TS, we inject the destination as
+ *     `interactiveRefactorArguments.targetFile` so the move targets an existing
+ *     file rather than prompting for a new one.
+ */
+import { type WorkspaceEdit } from '../apply.js';
+import { type GlobalFlags } from '../io.js';
+interface LspCommand {
+    title: string;
+    command: string;
+    arguments?: unknown[];
+}
+/**
+ * A `textDocument/codeAction` response item. Per the LSP spec the response is
+ * `(Command | CodeAction)[]`, so an item may be a full {@link CodeAction} OR a
+ * raw {@link LspCommand} — the latter carries its payload in a TOP-LEVEL
+ * `arguments` field (and `command` is then a `string`). We model both so a
+ * command-only action's `arguments` are not dropped.
+ */
+interface CodeAction {
+    title: string;
+    kind?: string;
+    edit?: WorkspaceEdit;
+    /** Nested command (CodeAction shape) or a command name (raw Command shape). */
+    command?: LspCommand | string;
+    /** Present only on the raw `Command` shape, alongside a string `command`. */
+    arguments?: unknown[];
+    data?: unknown;
+}
+/**
+ * Normalize the `command` of a code action into an {@link LspCommand}, preserving
+ * arguments for BOTH shapes:
+ *  - nested object command → used as-is;
+ *  - raw `Command` (string `command`) → its top-level `arguments` are retained
+ *    (dropping them left command-only `_typescript.applyRefactoring` moves with
+ *    an empty arg list, so the refactor could not run).
+ */
+export declare function toLspCommand(action: CodeAction): LspCommand | undefined;
+/**
+ * Resolve the ordered list of {@link WorkspaceEdit}s a `refactor.move` action
+ * produces, honoring the LSP `edit` + `command` contract:
+ *  - if the action has an inline `edit`, it is applied FIRST;
+ *  - if it also (or instead) has a `command`, the command is executed AFTER the
+ *    inline edit, and EVERY edit the server then pushes via `workspace/applyEdit`
+ *    (possibly several, in sequence) is appended in arrival order.
+ *
+ * Pure with respect to disk: it only sequences edits. `execute` runs the command
+ * (injecting the move target); `drainCapturedEdits` returns all server-pushed
+ * edits captured since the last drain.
+ */
+export declare function resolveMoveEdits(action: CodeAction, targetFile: string, execute: (cmd: LspCommand) => Promise<void>, drainCapturedEdits: () => WorkspaceEdit[]): Promise<WorkspaceEdit[]>;
+export declare function runMoveSymbol(args: {
+    file: string;
+    position: string;
+    targetFile: string;
+}, flags: GlobalFlags): Promise<void>;
+export {};
+//# sourceMappingURL=move-symbol.d.ts.map

package/dist/commands/move-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-symbol.d.ts","sourceRoot":"","sources":["../../src/commands/move-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,UAAU,CAAC;AAGlB,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AACD;;;;;;GAMG;AACH,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAQvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EAC3C,kBAAkB,EAAE,MAAM,aAAa,EAAE,GACxC,OAAO,CAAC,aAAa,EAAE,CAAC,CAS1B;AAyBD,wBAAsB,aAAa,CACjC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC5D,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAmFf"}