Add Tarantool debugging facilities

[georgiy-belyanin]

This patch introduces basic Tarantool debugging facilities into the
extension. Basically it is done using EmmyLuaDebugger [^1].

Set up the debugger using the following instructions.

• Insert debugger code in Tarantool application by pressing
  Ctrl+Shift+P (or Cmd+Shift+P on MacOS) and running Tarantool: Insert debugger code command.
• Start single Tarantool instance.
• Press F5 or run Debug: Start debugging command by pressing
  Ctrl+Shift+P (or Cmd+Shift+P on MacOS).
• Choose EmmyLua New Debugger in the list. This debugging
  configuration would run automatically from now.
• Set up breakpoints & access the Tarantool instance through Debug console in the bottom panel.

These features are supported.

• Breakpoints.
• Step-by-step execution within the fiber.
• Multiple files support.
• Interacting with the local variables, console at the debug mode.

Needs EmmyLua/EmmyLuaDebugger#75 to be tested
on MacOS on arm64.

Closes #19

[^1] EmmyLua/EmmyLuaDebugger#75

[Copilot]

Pull Request Overview

This PR adds basic Tarantool debugging support via EmmyLuaDebugger.

• Introduces insertDebuggerCode in src/utils.ts to inject a Lua snippet for debugging.
• Registers a new VS Code command tarantool.debugger-code and updates package.json.
• Updates documentation and changelog to describe debugger usage.

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/utils.ts	Implements insertDebuggerCode and debugger snippet
src/extension.ts	Registers the tarantool.debugger-code command
package.json	Declares the new debugger insertion command
README.md	Adds debugger usage instructions
CHANGELOG.md	Logs added support for EmmyLua-based debugging

Comments suppressed due to low confidence (5)

README.md:59

• [nitpick] Fix the grammar here. For example, replace 'It is employs' with 'It employs' to improve readability.

Tarantool VS Code extension provides debugger facility for developing Tarantool applications. It is employs EmmyLuaDebugger that is a stop-the-world Lua debugger.

README.md:34

• This line was removed but the initialization command may still be available. If so, restore or update this step to keep the usage instructions complete.

* Run `Tarantool: Initialize VS Code extension in existing app` command from the command palette (`Ctrl+Shift+P` or `Cmd+Shift+P` on macOS).

src/utils.ts:52

• The new insertDebuggerCode function lacks any test coverage. Consider adding unit tests for its platform-specific path logic and snippet insertion behavior.

export async function insertDebuggerCode() {

src/utils.ts:36

• The global function emmyHelperInit() is never defined. You should call the init method exposed by the emmy_core module (e.g., dbg.init() or assign dbg.init to _G.emmyHelperInit) so the debugger actually starts.

_G.emmyHelperInit()

src/utils.ts:33

• [nitpick] This assignment of _G.emmyHelper is duplicated and never used elsewhere. Consider removing it or clarifying its purpose to avoid global clutter.

rawset(_G, 'emmyHelper', {})

[Copilot]

Pull Request Overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.