chopsticks/BETA.md

2.3.0 Release Candidate Testing

This branch is the 2.3.0 release candidate. The goal is to prove that the Space layout can serve as the project loop for experienced Vim users, not just that the mappings work in isolation. Do not tag or publish it as 2.3.0 until the checklist below is closed.

Inside Vim, run :ChopsticksBeta for the compact checklist, :ChopsticksBetaLog for editable local notes, and :ChopsticksBetaSession to append a new session block. Run :ChopsticksHelp or :help chopsticks for the native Vim reference.

Install the release candidate

Existing checkout:

cd ~/.vim
git fetch origin
git checkout release/2.3.0
git pull --ff-only
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'

Fresh checkout:

git clone --branch release/2.3.0 https://github.com/m1ngsama/chopsticks.git ~/.vim
ln -sf ~/.vim/.vimrc ~/.vimrc
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'

Keep local choices in ${XDG_CONFIG_HOME:-~/.config}/chopsticks.vim:

let g:chopsticks_profile = 'engineer'
let g:chopsticks_keymap_style = 'space'

Inside Vim, :ChopsticksConfig opens that file and :ChopsticksReload reloads chopsticks after saving it.

Daily test loop

Use the release candidate for real editing, not only demos. A session should exercise the trained loop until it either feels automatic or exposes friction. For each session, record:

• The task: project navigation, code edit, grep, git, LSP, Markdown, SSH.
• The first key you tried when you got stuck.
• Whether SPC ?, :ChopsticksTutor, or :ChopsticksStatus answered it.
• Any mapping that felt slow, awkward, surprising, or too easy to mistype.
• Any documentation line that was wrong, missing, or redundant.

:ChopsticksBetaLog opens ${XDG_CONFIG_HOME:-~/.config}/chopsticks-2.3.0.md by default. Set g:chopsticks_beta_log before loading chopsticks to use a different path. Use :ChopsticksBetaSession at the start of each real editing session so every test has a timestamped block.

Workflows to exercise

SPC SPC   find file              SPC /     grep project
s + 2ch   jump on screen         gd / gr   definition / references
SPC rr    run current file       SPC gs    git status
SPC cf    format                 SPC ca    code action
SPC fc    local config           SPC ?     active cheat sheet
Ctrl-hjkl windows                SPC e     sidebar
:ChopsticksStatus health         :ChopsticksConfig preferences

Also test the boring path: save, quit, reopen Vim, edit over SSH, open a large file, edit Markdown, and use a machine with missing optional tools.

Exit criteria

• s as the default visible jump still feels worth the native override after real editing.
• No high-frequency action requires remembering an undocumented key.
• Window/sidebar navigation feels faster than native <C-w> only.
• README, QUICKSTART, :help chopsticks, SPC ?, and :ChopsticksTutor teach the same layout.
• No private wiki or external note is needed to remember the daily loop.
• scripts/test.sh quick and scripts/test.sh vim pass locally.
• The README GIF has been regenerated from .github/demo.tape after any public key change.
• The release candidate has been tested on macOS and over SSH on Linux.

Roll back

Return to the latest stable release:

cd ~/.vim
git fetch origin --tags
git checkout v2.2.0
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'

Or keep the code but switch back to the legacy layout:

let g:chopsticks_keymap_style = 'classic'