refactor: migrate test suite to Neovim/Lua (#171)

* chore: migrate Ruby version management to mise

Replace .tool-versions with mise.toml, pinning to Ruby major version 4
to avoid unexpected breaking changes from future major version bumps.

* fix: remove pry and pry-byebug incompatible with Ruby 4

byebug's native extension fails to compile against Ruby 4's updated C
API. Neither gem is referenced in the test suite, so they are safe to
remove. Also regenerates Gemfile.lock with current compatible versions.

* docs: add local development setup instructions

Document the mise + bundle install workflow so contributors know how to
get a working local environment.

* ci: replace ruby/setup-ruby with jdx/mise-action

Use mise to install Ruby in CI, keeping the toolchain consistent with
local development. Removes the hardcoded ruby-version matrix — the
version is now sourced from mise.toml. Also bumps actions/checkout to
v6.0.2.

* feat: add Neovim/Plenary test infrastructure (PoC + first test)

Introduces a Lua-based test suite driven by Neovim headless mode and
Plenary.nvim, replacing the broken Vimrunner/MacVim client-server setup.

- test/minimal_init.lua: bootstraps Plenary from /tmp and loads the plugin
- test/helpers.lua: feedkeys, new_buffer, test_bullet_inserted utilities
- test/poc_spec.lua: infrastructure smoke tests
- test/bullets_spec.lua: first ported spec (basic bullet insertion)
- mise.toml: adds `mise run test` task; no Makefile needed

* test: migrate batch 1 specs to Lua/Plenary (wrapping, filetypes, asciidoc)

Key learnings captured in test infrastructure:
- feedkeys 'tx' exits insert mode; for non-bullet CR tests use two feedkeys
  calls where the second prefixes 'i' to re-enter insert mode
- Non-bullet-line CR is deferred via feedkeys('n') by the plugin; the 'x'
  flag drains it within the first call, leaving normal mode on the new line
- vim.wait() exits insert mode — do not use it between feedkeys calls
- startinsert! is not synchronous from Lua — cannot bridge feedkeys calls
- set formatoptions= + comments= in minimal_init and per-test to prevent
  Neovim's '#' comment-continuation from corrupting test buffers
- nested dot bullet test (asciidoc) passes in Neovim — pending mark removed

* test: migrate batch 2 specs to Lua/Plenary (alphabetic, renumber, checkboxes)

Additional learnings added to minimal_init.lua:
- set noexpandtab globally to prevent user config leaking \t → spaces
- new_buffer() positions cursor at last line, so tests navigating from
  line 1 must prefix 'gg' before their first motion
- expandtab contamination affects <C-t> indent tests; fixed globally

* test: migrate batch 3 specs to Lua/Plenary (bullets, nested_bullets)

Completes full test suite migration — all 63 tests passing.

Additional learnings:
- set expandtab=false + shiftwidth/tabstop=4 in before_each for indent tests
- visual mode selection is re-entered by plugin after </> ops; subsequent
  operations stay in visual — no <Esc> needed between chained motions
- A<CR><CR> in one feedkeys call handles the empty-bullet deletion case
  (both CRs fire while in insert mode, second deletes the empty bullet)
- .strip in Ruby tests hides trailing "- " (with space); Lua tests assert
  the actual content including the trailing space
- mid-test config changes (e.g. g:bullets_enable_roman_list) work by setting
  the global between separate feedkeys calls

* test: review and fix test accuracy

* chore(mise): add neovim

* ci: run lua tests in github actions

* chore: remove ruby tests

* chore: add dprint and formatting tasks

* refactor: format lua tests

* fix: include yaml in dprint

* fix(dprint): include all supported file types

* chore: format README

* chore: check formatting

* chore: add git hooks tooling

Author: dkarter

.github/workflows/test.yml

@@ -2,28 +2,36 @@ name: Test
 
 on:
   push:
-    branches: [ master ]
+    branches: [master]
   pull_request:
-    branches: [ master ]
+    branches: [master]
   workflow_dispatch:
 
 jobs:
-  test:
-
+  fmt:
+    name: Check Formatting
     runs-on: ubuntu-latest
 
     steps:
-    - name: Checkout Code
-      uses: actions/checkout@v6.0.2
+      - name: Checkout Code
+        uses: actions/checkout@v6.0.2
 
-    - name: Install system dependencies
-      run: sudo apt install vim-gtk3 xvfb
+      - name: Set up tools via mise
+        uses: jdx/mise-action@v4.0.1
 
-    - name: Set up Ruby via mise
-      uses: jdx/mise-action@v4.0.1
+      - name: Check formatting
+        run: mise run fmt:check
+
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v6.0.2
 
-    - name: Install gems
-      run: bundle install
+      - name: Set up tools via mise
+        uses: jdx/mise-action@v4.0.1
 
-    - name: Run headless tests
-      run: xvfb-run -a bundle exec rspec
+      - name: Run Lua tests
+        run: mise run test

.gitignore

@@ -1,4 +1,3 @@
 doc/tags
 vendor/
-spec/examples.txt
 doc/tags

.rspec

@@ -1,7 +1,9 @@
 ![Bullets.vim](img/bullets-vim-logo.svg)
 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+
 [![All Contributors](https://img.shields.io/badge/all_contributors-16-orange.svg?style=flat-square)](#contributors-)
+
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 > :information_source: Looking for help/maintainers https://github.com/dkarter/bullets.vim/issues/126
@@ -23,6 +25,7 @@ Renumbering lines:
 # Installation
 
 ### With Vim 8.1+ native package manager:
+
 Clone into
 
 `.vim/pack/plugins/start`
@@ -35,8 +38,7 @@ Make sure to include `packloadall` in your `vimrc`.
 Plug 'bullets-vim/bullets.vim'
 ```
 
-Then source your bundle file and run `:PlugInstall`.
-
+Then source your Vim config and run `:PlugInstall`.
 
 # Usage
 
@@ -306,20 +308,20 @@ let g:bullets_checkbox_partials_toggle = 0
 
 # Mappings
 
-* Insert new bullet in INSERT mode: `<cr>` (Return key)
-* Same as <cr> in case you want to unmap <cr> in INSERT mode (compatibility depends on your terminal emulator): `<C-cr>`
-* Insert new bullet in NORMAL mode: `o`
-* Renumber current visual selection: `gN`
-* Renumber entire bullet list containing the cursor in NORMAL mode: gN
-* Toggle a checkbox in NORMAL mode: `<leader>x`
-* Demote a bullet (indent it, decrease bullet level, and make it a child of the previous bullet):
-  + NORMAL mode: `>>`
-  + INSERT mode: `<C-t>`
-  + VISUAL mode: `>`
-* Promote a bullet (unindent it and increase the bullet level):
-  + NORMAL mode: `<<`
-  + INSERT mode: `<C-d>`
-  + VISUAL mode: `<`
+- Insert new bullet in INSERT mode: `<cr>` (Return key)
+- Same as <cr> in case you want to unmap <cr> in INSERT mode (compatibility depends on your terminal emulator): `<C-cr>`
+- Insert new bullet in NORMAL mode: `o`
+- Renumber current visual selection: `gN`
+- Renumber entire bullet list containing the cursor in NORMAL mode: gN
+- Toggle a checkbox in NORMAL mode: `<leader>x`
+- Demote a bullet (indent it, decrease bullet level, and make it a child of the previous bullet):
+  - NORMAL mode: `>>`
+  - INSERT mode: `<C-t>`
+  - VISUAL mode: `>`
+- Promote a bullet (unindent it and increase the bullet level):
+  - NORMAL mode: `<<`
+  - INSERT mode: `<C-d>`
+  - VISUAL mode: `<`
 
 Disable default mappings:
 
@@ -345,34 +347,25 @@ Just add above to your .vimrc
 
 # Testing
 
-The test suite is written using vimrunner. It is known to run on macOS with MacVim installed, and on travis. Your vim must have `+clientserver` and either have its own GUI or in a virtual X11 window.
+The test suite is written in Lua and runs under Neovim with [Plenary](https://github.com/nvim-lua/plenary.nvim).
 
 ## Local Development Setup
 
-This project uses [mise](https://mise.jdx.dev) to manage the Ruby version. Install it, then run:
+This project uses [mise](https://mise.jdx.dev) to install Neovim. Install mise, then run:
 
 ```sh
 mise install
-bundle install
 ```
 
 ## Running Tests
 
-On your mac run:
-
-```sh
-bundle exec rspec
-```
-
-On linux:
+Run the full test suite with:
 
 ```sh
-bundle install
-xvfb-run bundle exec rspec
+mise run test
 ```
 
-You should see a Vim window open which will run each test, same general idea as
-Capybara integration testing. ❤️
+The test task runs Neovim headlessly and downloads Plenary to `/tmp/plenary.nvim` on first run.
 
 # TODO
 
@@ -385,11 +378,11 @@ Capybara integration testing. ❤️
 - [x] reset numbers (user selects numbered bullets 3-5 and copies to middle of document, then reselects and resets them to 1-3)
 - [x] check if plugin initialized and don't load if it did
 - [x] allow <C-cr> for return without creating a bullet (only possible in GuiVim
-  unfortunately)
+      unfortunately)
 - [x] check if user is at EOL before appending auto-bullet - they may just want to
 - [x] attempt to keep the same total bullet width even as number width varies (right padding)
 - [x] detect lists that have multiline bullets (should have no empty lines between
-  lines).
+      lines).
 - [x] add alphabetic list
 - [x] support for intelligent alphanumeric indented bullets e.g. 1. \t a. \t 1.
 - [x] change nested outline levels in visual mode
@@ -406,9 +399,7 @@ Capybara integration testing. ❤️
 [![Hashrocket logo](https://hashrocket.com/hashrocket_logo.svg)](https://hashrocket.com)
 
 Bullets.vim is kindly supported by [Hashrocket, a multidisciplinary design and
-development consultancy](https://hashrocket.com). If you'd like to [work with
-us](https://hashrocket.com/contact-us/hire-us) or [join our
-team](https://hashrocket.com/contact-us/jobs), don't hesitate to get in touch.
+development consultancy](https://hashrocket.com). If you'd like to [work with us](https://hashrocket.com/contact-us/hire-us) or [join our team](https://hashrocket.com/contact-us/jobs), don't hesitate to get in touch.
 
 ## Contributors ✨
 

.rubocop.yml

@@ -0,0 +1,3 @@
+subject_capitalized = false
+style = "conventional"
+subject_length = 72