ruby_jard 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94dbda134fd22365f583f71fa2aaddffae206045cc8da4fd6ee51e2eeaebfca7
-  data.tar.gz: af8c443ac2c40619cead142c3e77dd3b7f7ad59c19993966edcdd1eae8c31a3d
+  metadata.gz: 49f057d809cf1b9208df17537c1fb2f80b0380193d497351314d567a75e9ddc5
+  data.tar.gz: 74d8fa560a06dcc07579f1ccf8761c85c65c7110dfd6d0cbe93aeaab817934e4
 SHA512:
-  metadata.gz: 6d18a6894bcb24bae3bf30244dfcf1f39412e9804df5897e7adac6b74cdb8929b3353a8a0999ec55b687bfa60e87890a5db637bfe7d046b30a470b0d5158c46e
-  data.tar.gz: 7eaacc77cd4eaa4fdb7e183292872cef01217e5c92f75bea1882d454dad1ad1ae97ff3790ca129e76de4f893167d1b1b81b6deb7eb44b6931d67a23cca03f7f5
+  metadata.gz: d0da56029611ab8712f889b284c2e5a672e8b9609f76636b4cd354f08b65f3429c331324c31fa136572088eabdbf5a7aa1ebaedba526f517f4080145a73e2ff6
+  data.tar.gz: 3fb4581a4e913aa2fbe2985b8b842f76e78f8e1207a6ac0847ea52e898a1e1ac02178ff3ec46949e17b85e383a9fa3853428592ad3e4359aae1c71d008d83975

data/.rubocop.yml

@@ -1,3 +1,5 @@
+Lint/NonLocalExitFromIterator:
+  Enabled: false
 Naming/MethodParameterName:
   Enabled: false
 Style/SymbolArray:
@@ -18,6 +20,7 @@ Metrics/ParameterLists:
   Enabled: false
 Metrics/ClassLength:
   Enabled: false
+Layout/HashAlignment:
+  Enabled: false
 AllCops:
   TargetRubyVersion: 2.5
-

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.2.1 - Alpha 3] - Render mechanism and theme system
+### UX/UI
+- New color scheme: 256, as the default color scheme. It works well with all 256-color terminal emulators.
+- New color scheme: deep-space. It's a 24-bit color scheme.
+- UX change: swap positions of default panels:
+    ```
+      Source    | Backtrace
+      Variables | Threads
+    ```
+- New narrow layout, which consists of source and variables only. Useful when running tests.
+- Add aliases to common commands
+### Bug fixes
+- https://github.com/nguyenquangminh0711/ruby_jard/issues/2
+- Fix display bug that some rows are out of screen if above rows have word wraps.
+### Internal Refactoring
+- New rendering mechanism, that supports data windowing, selection locating, and cursor.
+- Improve compatibility, and add fallbacks in case io/console, or tput are not available.
+
 ## [0.2.0 - Alpha 2] - UI completeness
 
 ### UX/UI

data/CNAME

@@ -0,0 +1 @@
+rubyjard.org

data/README.md

@@ -1,29 +1,20 @@
-# RubyJard
+![Ruby Jard](./docs/logo.jpg)
 
-Jard stands for Just Another Ruby Debugger. It implements a layer of UI wrapping around byebug, aims to provide a unified experience when debugging Ruby source code. Ruby Jard supports the following major features at the moment:
+Jard stands for Just Another Ruby Debugger, aims to provide a better experience while debugging Ruby. Ruby Jard supports the following major features at the moment:
 
-- Default Terminal UI, in which the layout and display are responsive to support different screen sizes.
+- Informative Terminal UI, reduce your mental effort for repeated stuff so that you can focus on killing bugs.
 - Highlighted source code screen.
-- Stacktrace visualization and navigation.
-- Auto explore and display variables in the current context.
+- Backtrace visualization and navigation.
+- Auto variable display in the current context.
 - Multi-thread exploration and debugging.
 
-In the roadmap:
-- Dynamic breakpoints.
-- Watch expressions.
-- Support different screen sizes.
-- Minimal layout configuration.
-- Fully layout configuration with Tmux.
-- Integrate with Vim.
-- Integrate with Visual Studio Code.
-- Encrypted remote debugging.
-- Some handful debug tools and data visualization.
+Ruby Jard's core is [Byebug](https://github.com/deivid-rodriguez/byebug), an awesome de factor debugger for Ruby. Therefore, Ruby Jard supports most of Byebug's functionalities.
 
-Ruby Jard's core is Byebug, an awesome de factor debugger for Ruby. Therefore, Ruby Jard supports most of Byebug's functionalities.
+If you still don't know what it is, let's watch this video.
 
-If you still don't know what it is, let's watch this video. This is a record of debugging Code Ray - A syntax highlighter for Ruby.
+[![Ruby Jard Demo](./docs/demo.png)](https://asciinema.org/a/350233)
 
-[![asciicast](https://asciinema.org/a/ejWK3Px55QNQmhM4nbd1lSigW.svg)](https://asciinema.org/a/ejWK3Px55QNQmhM4nbd1lSigW)
+*[(Click for demo video)](https://asciinema.org/a/350233)*
 
 ## Getting Started
 
@@ -46,24 +37,206 @@ def test_method
 end
 ```
 
-## Guides
+## Screens
+
+When Jard attaches at any line of code, the main tile-style UI shows up. By default, there are 5 areas on the UI that you'll be interested.
+
+### Source panel
+
+<img src="./docs/screen-source.png" alt="Source screen" />
+
+This panel shows the current line of code that your program is stopping, and surrounding related lines. The number of lines shown in this panel depends on your current terminal height, but never less than 5.
+
+Ruby Jard supports any file extensions that your program runs into, especially `.rb`, `.erb`, `.haml` files. Other file types may encounter minor syntax highlighting issues.
+
+Ruby Jard also supports inspecting gems and libraries, if you are interested.
+
+### Backtrace panel
+
+<img src="./docs/screen-backtrace.png" alt="Screen backtrace"/>
+
+This panel describes the current backtrace of the current thread your program is stopping. Each line of this panel describes the current Frame. What is frame and backtrace by the way? Let's step back a little bit at how Ruby executes your code. Internally, Ruby uses an interpreter to read and execute your code, line by line (technically, YARD instructions, but let's go with a simple version). When it meets a chunk of code that needs to open a new scope, like method calls or inline-block call, the interpreter creates a new structure to store the current context so that it can link to the next scope and go back later. This data structure is call Frame. The interpreter pushes frame into a stack, called backtrace (or stack trace, or call stack, whatever), and continues to execute your code. Each thread has a separate backtrace. To understand deeply, you may be interested in this wonderful slide: [Grow and Shrink - Dynamically Extending the Ruby VM Stack](https://www.slideshare.net/KeitaSugiyama1/grow-and-shrink-dynamically-extending-the-ruby-vm-stack).
+
+Overall, the whole backtrace panel lets you know where you are stopping at, the trace of how your program is running. When combining with other tools and other panels, you will be surprised by how much information the bugger can help you when you encounter your bugs.
+
+Each frame includes the following information:
+
+- Frame ID: incremental, can be used to jump to an arbitrary frame with frame command.
+- Current location label: a class name and method name of the method covers its frame. If there is a `[c]` prefix in front of a class name, it means that the method is provided by Ruby, implemented in C, and impossible to peek.
+- Current physical location: exact file name and line number. If a frame is allocated in a gem, the physical location shows a gem name and version only. For example: `RSpec::Core::Hooks::HookCollections in run in rspec-core (3.9.2)`.
+
+### Variable panel
+
+<img src="./docs/screen-variables.png" alt="Variables screen"/>
+
+The variable panel lets you explore all the local variables, instance variables, and constants in the current display context. Each variable is described by:
+
+- Inline indicator: the beginning dot (`•`) implies a variable that appears in the current line.
+- Variable type: allow you to know the type of a variable at a single glance. Only built-in types, such as `int`, `flt`, `hash`, `bool`, `rng`, are supported. Instances of any classes will be noted as `var`.
+- Size of variable: the size of collection-like variables. Current Jard version supports 3 types:
+  - Hash: this field shows the number of keys
+  - Array: this field shows the number of items
+  - String: this field shows the number of character (fetched from`String#size` method)
+- Variable inspection: the content of the variable. The current Jard version generates this field by calling `#inspect`. **Known issue**: this accidentally triggers materializing method of objects, such as `ActiveRecord::Relation`. Future Jard version gonna fix this by a new safe generator.
+
+This panel interacts well with backtrace panel and backtrace-exploring commands such as (`up`, `down`, `frame`, etc.) to inspect relative variables at each frame layer in the program. A common use case is to recall the parameter values you forgot when digging too deep into a method call.
+
+By default, the variables are sorted by the following criteria:
+
+- Pinned variables (coming soon)
+- Current context (self)
+- Local variables
+- Instance variables
+- Constants
+- Global variables (coming soon)
+
+### Thread panel
+
+<img src="./docs/screen-threads.png" alt="Screen threads" />
+
+Show all the threads running at the moment. This panel is useful when you are working with a complicated multi-threaded environment like web server, or background jobs.
+
+### Repl panel
+
+<img src="./docs/screen-repl.png" alt="Screen repl" />
+
+An interactive Repl for you to interact with your program, inspect values, update values, or control the debug flow as you want. The heart of Jard's repl is [Pry](https://github.com/pry/pry), a masterpiece gem. When you type a command, Jard parses, and does corresponding actions if what you type matches supported command. Otherwise, they are evaluated as Ruby code.
+
+## Commands
+
+### List
+
+**Repl command**: `list`
+
+**Key binding:** F5
+
+**Alias**: `l`
+
+Refresh the whole terminal UI. This command doesn't move you to other steps, nor change any data in your session. It is useful (or the only way) to get back the beautiful UI if you type too much in the REPL console.
+
+### Step
+
+**Repl command**: `step`
+
+**Key binding**: F7
+
+**Alias**: `s`
+
+Detect and step into a method call or block in the current line. If there isn't anything to step in, the program continues to next line. In case there are multiple methods on the same line, Jard hornors Ruby's execution order.
+
+### Step out
+
+**Repl command**: `step-out`
 
-![Guide UI](./docs/guide-ui.png)
+**Key binding**: Shift + F7
+
+**Alias**: `so`
+
+The opposite of step out. This command is used to finish the execution of current frame, and jump to the next line of upper frame. In other words, this command is equivalent to the sequence `up` and `next`. If the neighbor frame already finishes, it continues with even higher frame.
+
+This command is useful when you loose your interest in frame, and want to quickly go up again. One example is that you accidentally step into a longgggg loop with nothing useful. Another example is that you step into the library source code and don't really care what it does underlying.
+
+### Next
+
+**Repl command**: `next`
+
+**Key binding**: F8
+
+**Alias**: `n`
+
+Continue to the next line in the current frame, by pass any steppable method call or blocks in the mid way unless they contains dynamic breakpoint or any `jard` attachment command. If the current frame already reaches the end, it continues to the next line of upper frame and so on.
+
+### Continue
+
+**Repl command**: `continue`
+
+**Key binding**: F9
+
+**Alias**: `c`
+
+Continue the execution of your program to the end, or stop at the first dynamic break point or `jard` attachment command. One common confusion is that long-running ruby processes, such as web server or background jobs, won't stop, and may be used to debug the next request without restarting. If you want to end everything and just exit the process, let's use `exit`.
+
+### Up
+
+**Repl command**: `up`
+
+**Key binding**: F6
+
+Explore the upper frame. When you use this command, all associated displaying screens will be updated accordingly, but your program current position is still at the latest frame. This command is mostly used to explore, and view the trace, input parameters, or how your program stops at the current position. When use this command, you should have a glance at Variable panel, and Source panel to see the variables at destination frame.
+
+You can combine with `next` or `step` to perform powerful execution redirection at the destination frame. Let's look at an example. You are debugging a chain of 10 rack middlewares, you go deep into the #9 middleware, found something, then want to go back to #5 middleware. It's pretty boring and frustrated to just use `next` or `step-out` and hope it eventually goes back. Now use `up` for some times (or `frame`, described below) to go to your desired frame, and use `next` there. Tada, it's magical, just like teleport.
+
+One note is that you cannot explore a frame in c.
+
+### Down
+
+**Repl command**: `down`
+
+**Key binding**: Shift+F6
+
+Explore the lower frame. See `up` command for more information.
+
+### Frame
+
+**Repl command**: `frame <frame_id>`
+
+**Key binding:** None
+
+**Examples**:`frame 10`
+
+Explore a particular frame with id `<frame_id>`. It's faster than `up` and `down`. See `up` command for more information.
+
+### [Done] Version 0.1.0: Proof of concept
+
+This version is a bootstrap to see whether my idea works or not, in term of technical possibility and user usability. Luckily, everything works now, and I receive possible feedback from friends and peers.
+
+### [Done] Version 0.2.0: UI completeness
+
+The bootstrap version is just a series of ugly prints on stdout. It's frustrated as many things can be broken, wrong drawing, text overlapping, etc. This version is to fix those issues, and provide a foundation for more complicated drawing.
+
+### Version 0.3.0: Complete the workflow
+
+This version focuses on making Jard usable for daily activities of any developer. In other words, this version is to become a complete replacement for Byebug (sorry :pray:).
+
+- Dynamic breakpoints.
+- Watch expressions.
+- Pin variables.
+- Program's STDOUT panel.
+- Post moterm.
+- Trace variable changes.
+- Multi-threaded debugging.
+- Fulfill options for existing commands.
+- Add more commands to control workflow.
+- etc.
+
+### Version 0.4.0: User satisfaction
+
+Ruby Jard now serves well for all debugging use case. But it becomes floated, hard to use, and maybe just not "click" for the user. This version focuses on improve userability, stability, bugs, tweak small details. So that, after this version, Ruby Jard is just pleasant to use.
+
+- Support different screen sizes.
+- Minimal layout configuration.
+- Allow customizations (keyboard shortcut for example).
+- Rebuild variable inspection to optimize for each data type, especially nested complicated structure.
+- Collapsible and expandale variable inspection.
+- Windows, viewport, scrolling, etc.
+- Navigate between panels.
+- Build a buffer system to reduce interaction with STDOUT, and eventually improve drawing latency.
+
+### Version 0.5.0: Integration
+
+Accept or not, not everyone uses vim, or even terminal. Even in the terminal, I just want to provide minimal layout customizations, as I don't want to rebuild Tmux. Therefore, integration with other powerful systems to extend use cases, adapt different work flow and preferences is the focus on this version. I'm not sure about the ultimate solution, but at my limited knowledge now, [Debugger Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) looks promising.
+
+- Prepare the infrastructure for DAP protocol.
+- Separate and split the panels into possible isolated processes, connect them together with DAP.
+- Fully layout configurations and integrate with Tmux.
+- Integrate with Vim 8+/Neovim via Terminal mode.
+- Integrate with Visual Studio Code via DAP.
+- Integrate with Emacs via dap mode.
+- Encrypted remote debugging.
 
-The main page of the debugging UI includes 4 screens:
-- Source: Show the current file, surrounding the source code of the executing line.
-- Stacktrace: Show the current thread's stack trace. You can use `up`, `down`, `frame` to navigate through the stack trace.
-- Variables: Show all the variables in the current context, including local variables, instance variables, and constants.
-- Threads: Show all the threads of the process. This screen is valuable in case you are debugging a multi-threaded program.
+### Further future
 
-At this alpha state, Ruby Jard support some basic commands:
-- `next`: continue the execution to the next line.
-- `step`: continue the execution, do deep into the implementation of methods in the current line.
-- `continue`: continue the execution. The program gonna stops at the next breakpoint.
-- `finish`: Finish the execution of the current frame, and go back.
-- `up`: explore the stack trace, jump to the upper frame of the current program
-- `down`: explore the stack trace, jump to the lower frame of the current program
-- `frame`: explore the stack trace, jump to a precise frame in the stack trace.
+I won't stop until 0.5.0 version, even Jard doesn't have any users. However, as soon as it reaches 0.5.0, and serves my interest well, I don't have much things in mind now. The future is uncertain. Dreaming is good. Making dreams come true is hard, and time-consuming. Hope I can reach that future.
 
 ## Contributing
 

data/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-cayman

data/docs/_config.yml

@@ -0,0 +1,8 @@
+title: Ruby Jard
+description: Just another ruby debugger. Provide a better experience while debugging Ruby
+google_analytics: 
+show_downloads: true
+theme: jekyll-theme-cayman
+
+gems:
+  - jekyll-mentions

data/docs/index.md

@@ -0,0 +1,238 @@
+![Ruby Jard](./docs/logo.jpg)
+
+Jard stands for Just Another Ruby Debugger, aims to provide a better experience while debugging Ruby. Ruby Jard supports the following major features at the moment: 
+
+- Informative Terminal UI, reduce your mental effort for repeated stuff so that you can focus on killing bugs.
+- Highlighted source code screen.  
+- Backtrace visualization and navigation. 
+- Auto variable display in the current context. 
+- Multi-thread exploration and debugging.
+
+Ruby Jard's core is [Byebug](https://github.com/deivid-rodriguez/byebug), an awesome de factor debugger for Ruby. Therefore, Ruby Jard supports most of Byebug's functionalities.
+
+If you still don't know what it is, let's watch this video. 
+
+[![asciicast](https://asciinema.org/a/348526.svg)](https://asciinema.org/a/348526)
+
+## Getting Started
+
+**Warning**: Ruby Jard is still under heavy development. Bugs and weird behaviors are expected. If you see one, please don't hesitate to open an issue. I'll try my best to fix.
+
+Add `ruby_jard` to your Gemfile, recommend to put it in test or development environment.
+
+``` ruby
+gem 'ruby_jard'
+```
+
+Add magic method `jard` before the line you want to debug, just like `byebug`
+
+```ruby
+def test_method
+  a = 1
+  b = 2
+  jard # Debugger will stop here
+  c = a + b
+end
+```
+
+## Screens
+
+When Jard attaches at any line of code, the main tile-style UI shows up. By default, there are 5 areas on the UI that you'll be interested.
+
+### Source panel
+
+<img src="./docs/screen-source.png" alt="Source screen" style="max-width: 500px;" />
+
+This panel shows the current line of code that your program is stopping, and surrounding related lines. The number of lines shown in this panel depends on your current terminal height, but never less than 5. 
+
+Ruby Jard supports any file extensions that your program runs into, especially `.rb`, `.erb`, `.haml` files. Other file types may encounter minor syntax highlighting issues.
+
+Ruby Jard also supports inspecting gems and libraries, if you are interested.
+
+### Backtrace panel
+
+<img src="./docs/screen-backtrace.png" alt="Screen backtrace" style="max-width: 500px;" />
+
+This panel describes the current backtrace of the current thread your program is stopping. Each line of this panel describes the current Frame. What is frame and backtrace by the way? Let's step back a little bit at how Ruby executes your code. Internally, Ruby uses an interpreter to read and execute your code, line by line (technically, YARD instructions, but let's go with a simple version). When it meets a chunk of code that needs to open a new scope, like method calls or inline-block call, the interpreter creates a new structure to store the current context so that it can link to the next scope and go back later. This data structure is call Frame. The interpreter pushes frame into a stack, called backtrace (or stack trace, or call stack, whatever), and continues to execute your code. Each thread has a separate backtrace. To understand deeply, you may be interested in this wonderful slide: [Grow and Shrink - Dynamically Extending the Ruby VM Stack](https://www.slideshare.net/KeitaSugiyama1/grow-and-shrink-dynamically-extending-the-ruby-vm-stack). 
+
+Overall, the whole backtrace panel lets you know where you are stopping at, the trace of how your program is running. When combining with other tools and other panels, you will be surprised by how much information the bugger can help you when you encounter your bugs.
+
+Each frame includes the following information:
+
+- Frame ID: incremental, can be used to jump to an arbitrary frame with frame command.
+- Current location label: a class name and method name of the method covers its frame. If there is a `[c]` prefix in front of a class name, it means that the method is provided by Ruby, implemented in C, and impossible to peek.
+- Current physical location: exact file name and line number. If a frame is allocated in a gem, the physical location shows a gem name and version only. For example: `RSpec::Core::Hooks::HookCollections in run in rspec-core (3.9.2)`.
+
+### Variable panel
+
+<img src="./docs/screen-variables.png" alt="Variables screen" style="max-width: 500px;" />
+
+The variable panel lets you explore all the local variables, instance variables, and constants in the current display context. Each variable is described by:
+
+- Inline indicator: the beginning dot (`•`) implies a variable that appears in the current line. 
+- Variable type: allow you to know the type of a variable at a single glance. Only built-in types, such as `int`, `flt`, `hash`, `bool`, `rng`, are supported. Instances of any classes will be noted as `var`.
+- Size of variable: the size of collection-like variables. Current Jard version supports 3 types:
+  - Hash: this field shows the number of keys 
+  - Array: this field shows the number of items
+  - String: this field shows the number of character (fetched from`String#size` method)
+- Variable inspection: the content of the variable. The current Jard version generates this field by calling `#inspect`. **Known issue**: this accidentally triggers materializing method of objects, such as `ActiveRecord::Relation`. Future Jard version gonna fix this by a new safe generator.
+
+This panel interacts well with backtrace panel and backtrace-exploring commands such as (`up`, `down`, `frame`, etc.) to inspect relative variables at each frame layer in the program. A common use case is to recall the parameter values you forgot when digging too deep into a method call. 
+
+By default, the variables are sorted by the following criteria:
+
+- Pinned variables (coming soon)
+- Current context (self)
+- Local variables
+- Instance variables
+- Constants
+- Global variables (coming soon)
+
+### Thread panel
+
+<img src="./docs/screen-threads.png" alt="Screen threads" style="max-width: 500px;" />
+
+Show all the threads running at the moment. This panel is useful when you are working with a complicated multi-threaded environment like web server, or background jobs. 
+
+### Repl panel
+
+<img src="./docs/screen-repl.png" alt="Screen repl" />
+
+An interactive Repl for you to interact with your program, inspect values, update values, or control the debug flow as you want. The heart of Jard's repl is [Pry](https://github.com/pry/pry), a masterpiece gem. When you type a command, Jard parses, and does corresponding actions if what you type matches supported command. Otherwise, they are evaluated as Ruby code.
+
+## Commands
+
+### Step
+
+**Repl command**: `step`
+
+**Key binding**: F7
+
+Detect and step into a method call or block in the current line. If there isn't anything to step in, the program continues to next line. In case there are multiple methods on the same line, Jard hornors Ruby's execution order.
+
+### Step out
+
+**Repl command**: `step-out`
+
+**Key binding**: Shift + F7
+
+The opposite of step out. This command is used to finish the execution of current frame, and jump to the next line of upper frame. In other words, this command is equivalent to the sequence `up` and `next`. If the neighbor frame already finishes, it continues with even higher frame.
+
+This command is useful when you loose your interest in frame, and want to quickly go up again. One example is that you accidentally step into a longgggg loop with nothing useful. Another example is that you step into the library source code and don't really care what it does underlying.
+
+### Next
+
+**Repl command**: `next`
+
+**Key binding**: F8
+
+Continue to the next line in the current frame, by pass any steppable method call or blocks in the mid way unless they contains dynamic breakpoint or any `jard` attachment command. If the current frame already reaches the end, it continues to the next line of upper frame and so on. 
+
+### Continue
+
+**Repl command**: `continue`
+
+**Key binding**: F9
+
+Continue the execution of your program to the end, or stop at the first dynamic break point or `jard` attachment command. One common confusion is that long-running ruby processes, such as web server or background jobs, won't stop, and may be used to debug the next request without restarting. If you want to end everything and just exit the process, let's use `exit`.
+
+### Up
+
+**Repl command**: `up`
+
+**Key binding**: F6
+
+Explore the upper frame. When you use this command, all associated displaying screens will be updated accordingly, but your program current position is still at the latest frame. This command is mostly used to explore, and view the trace, input parameters, or how your program stops at the current position. When use this command, you should have a glance at Variable panel, and Source panel to see the variables at destination frame. 
+
+You can combine with `next` or `step` to perform powerful execution redirection at the destination frame. Let's look at an example. You are debugging a chain of 10 rack middlewares, you go deep into the #9 middleware, found something, then want to go back to #5 middleware. It's pretty boring and frustrated to just use `next` or `step-out` and hope it eventually goes back. Now use `up` for some times (or `frame`, described below) to go to your desired frame, and use `next` there. Tada, it's magical, just like teleport.
+
+One note is that you cannot explore a frame in c.
+
+### Down
+
+**Repl command**: `down`
+
+**Key binding**: Shift+F6
+
+Explore the lower frame. See `up` command for more information.
+
+### Frame
+
+**Repl command**: `frame <frame_id>`
+
+**Key binding:** None
+
+**Examples**:`frame 10`
+
+Explore a particular frame with id `<frame_id>`. It's faster than `up` and `down`. See `up` command for more information. 
+
+
+
+## Roadmap
+
+The ultimate goal of Ruby Jard is to provide a better experience while debugging Ruby. All the items in the roadmap are supposed to serve that. However, I have a life. There won't be any promises on when those items will be finished. In fact, this roadmap may be changed at anytime, depends on the current direction, focus and circumstances. 
+
+### [Done] Version 0.1.0: Proof of concept
+
+This version is a bootstrap to see whether my idea works or not, in term of technical possibility and user usability. Luckily, everything works now, and I receive possible feedback from friends and peers.
+
+### [Done] Version 0.2.0: UI completeness
+
+The bootstrap version is just a series of ugly prints on stdout. It's frustrated as many things can be broken, wrong drawing, text overlapping, etc. This version is to fix those issues, and provide a foundation for more complicated drawing.
+
+### Version 0.3.0: Complete the workflow
+
+This version focuses on making Jard usable for daily activities of any developer. In other words, this version is to become a complete replacement for Byebug (sorry :pray:). 
+
+- Dynamic breakpoints.
+- Watch expressions.
+- Pin variables.
+- Program's STDOUT panel.
+- Post moterm.
+- Trace variable changes.
+- Multi-threaded debugging.
+- Fulfill options for existing commands.
+- Add more commands to control workflow.
+- etc.
+
+### Version 0.4.0: User satisfaction
+
+Ruby Jard now serves well for all debugging use case. But it becomes floated, hard to use, and maybe just not "click" for the user. This version focuses on improve userability, stability, bugs, tweak small details. So that, after this version, Ruby Jard is just pleasant to use.
+
+- Support different screen sizes.
+- Minimal layout configuration.
+- Allow customizations (keyboard shortcut for example).
+- Rebuild variable inspection to optimize for each data type, especially nested complicated structure.
+- Collapsible and expandale variable inspection.
+- Windows, viewport, scrolling, etc.
+- Navigate between panels.
+- Build a buffer system to reduce interaction with STDOUT, and eventually improve drawing latency.
+
+### Version 0.5.0: Integration
+
+Accept or not, not everyone uses vim, or even terminal. Even in the terminal, I just want to provide minimal layout customizations, as I don't want to rebuild Tmux. Therefore, integration with other powerful systems to extend use cases, adapt different work flow and preferences is the focus on this version. I'm not sure about the ultimate solution, but at my limited knowledge now, [Debugger Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) looks promising.
+
+- Prepare the infrastructure for DAP protocol.
+- Separate and split the panels into possible isolated processes, connect them together with DAP.
+- Fully layout configurations and integrate with Tmux.
+- Integrate with Vim 8+/Neovim via Terminal mode.
+- Integrate with Visual Studio Code via DAP.
+- Integrate with Emacs via dap mode.
+- Encrypted remote debugging.
+
+### Further future
+
+I won't stop until 0.5.0 version, even Jard doesn't have any users. However, as soon as it reaches 0.5.0, and serves my interest well, I don't have much things in mind now. The future is uncertain. Dreaming is good. Making dreams come true is hard, and time-consuming. Hope I can reach that future.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/nguyenquangminh0711/ruby_jard. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/nguyenquangminh0711/ruby_jard/blob/master/CODE_OF_CONDUCT.md).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the RubyJard project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/ruby_jard/blob/master/CODE_OF_CONDUCT.md).