chopsticks/CHANGELOG.md

# Changelog

All notable changes to chopsticks are documented here.

---

## [1.2.0] - 2026-04-09

Installer robustness overhaul and one-command bootstrap.

### Added

- **`get.sh`** — one-command bootstrap: `curl -fsSL .../get.sh | bash`
  - Installs `git` if missing (apt / pacman / dnf / brew)
  - Clones repo to `~/.vim`; `git pull` if already present
  - `exec bash install.sh </dev/tty` — interactive prompts work correctly even when piped from curl
- **Network connectivity check** — warns early if `github.com` is unreachable
- **`curl` preflight** — detects missing curl, auto-installs or dies with clear instructions
- **`git` preflight** — same as curl
- **`vim` auto-install** — attempts `pkg_install` before dying if vim is not found
- **`sudo` availability check** — authenticates once upfront; `--yes` mode skips sudo gracefully with a warning
- **macOS Homebrew installer** — offers to install Homebrew when `brew` is missing on macOS
- **Node.js via nvm** — when Node.js is missing, offers to install nvm + Node.js LTS automatically
- **Python 3 installer** — offers to install python3 via package manager when missing
- **`safe_download()`** helper — verifies downloads are non-empty and not HTML error pages (guards against GitHub 404 / rate-limit pages being silently treated as binaries)
- **`pkg_install()`** helper — unified cross-platform install (brew / apt / pacman / dnf)
- **`arch_github()` / `arch_linux_x64()`** helpers — normalize `uname -m` including `aarch64` → `arm64`
- **`trap on_error ERR`** — catches unexpected failures, shows line number and debug command
- **`trap EXIT`** — cleans up temp files (`/tmp/chopsticks-hadolint`, `/tmp/chopsticks-marksman`)
- **Symlink verification** — confirms `[[ -L ]]` after `ln -sf`
- **vim-plug fallback** — if curl download fails, falls back to `git clone`; verifies file is non-empty
- **`vim +PlugInstall` error handling** — warns on non-zero exit instead of silent continue
- **Screen-dark notice** — informs user before each Vim fullscreen step (PlugInstall, CocInstall)

### Changed

- `set -e` → `set -eo pipefail` — pipeline failures now propagate correctly
- `ask()` now reads from `/dev/tty` with a test-open check (`{ true </dev/tty; }`) — interactive prompts work under `curl | bash` and non-interactive SSH sessions fall back to "no" safely
- Binary downloads (hadolint, marksman) use named temp files and `safe_download()` instead of bare curl
- Arch architecture detection handles `aarch64` in addition to `arm64`
- System tools section checks `HAS_SUDO` before running apt / pacman / dnf commands

---

## [1.1.1] - 2026-04-09

Systematic absorption of best practices from amix/vimrc, tpope/vim-sensible,
ThePrimeagen, skwp/YADR, and spf13-vim — settings and mappings that appear
consistently across all top global configs but were missing here.

### Added

- **`set ttimeoutlen=10`** — eliminates the ~500ms ESC lag in terminal Vim; separates
  keycode timeout from leader-key timeout (`timeoutlen` unchanged at 500ms)
- **`set display+=lastline`** — shows truncated long lines instead of replacing them with `@@@`
- **`set complete-=i`** — `Ctrl+n/p` no longer scans all included files; completion is instant
- **`set wildignorecase`** — case-insensitive filename completion in wildmenu and `:find`
- **`set path+=**`** — recursive `:find` across the project; wildignore excludes
  `node_modules`, `__pycache__`, `dist`, `build`, `.git`
- **`set sessionoptions`** — removes `options` from saved sessions (prevents stale plugin
  settings from contaminating restored sessions)
- **`set listchars`** — defines visible whitespace characters; TTY uses ASCII symbols,
  modern terminals use Unicode (tab `→`, trail `·`, extends `▸`)
- **`F6`** — toggle visible whitespace on/off
- **`formatoptions-=cro`** on `BufEnter` — disables automatic comment-leader insertion
  when pressing Enter or `o/O`; runs on BufEnter to override filetype plugins
- **`InsertLeave * set nopaste`** — auto-disables paste mode on leaving insert, preventing
  permanently broken auto-indent
- **`colorcolumn=+1`** for all languages via `textwidth`:
  Python 88, Go 120, JS/TS 100, Rust 100, Shell 80 (Markdown disabled)
- **`vnoremap J/K`** with `gv=gv` — move selected lines down/up and re-indent (ThePrimeagen)
- **`gV`** — re-select last pasted text (`\`[v\`]` — spf13, YADR)
- **`cnoremap <C-p>/<C-n>`** — navigate command-line history matching typed prefix (amix, spf13)
- **`<leader>e :Explore`** — open built-in Netrw file browser; works on any Vim without plugins
- **`<leader>cd`** — change window-local CWD to current file's directory (was `<leader>wd`)
- **`<leader>sv`** — reloads vimrc and echoes confirmation

### Changed

- `<leader>wd` renamed to `<leader>cd`; now uses `lcd` (window-local) instead of `cd` (global)
- `wildignore` expanded with `*/node_modules/*`, `*/__pycache__/*`, `*/dist/*`, `*/build/*`

---

## [1.1.0] - 2026-04-09

Ergonomics and automation overhaul: community-standard keybindings, seamless
tmux integration, an in-Vim cheat sheet, a beginner onboarding section, and
several correctness fixes from a systematic review.

### Added

- **`jk` → `Esc`** in insert mode — ergonomic escape without reaching for the key
- **`Ctrl+s` save** in normal and insert mode (add `stty -ixon` to shell rc to enable
  in terminals that use XON/XOFF flow control)
- **`//` visual search** — search for visually selected text using `\V` very-nomagic escaping
- **`<leader>p` / `<leader>P`** — paste from system clipboard after/before cursor
- **`<leader>rG`** — ripgrep word under cursor with `-F` (literal, not regex)
- **`<leader>u`** — leader-key alias for UndoTree (complements `F5`)
- **`<leader>tt`** — leader-key alias for Tagbar (complements `F8`)
- **`,?` in-Vim cheat sheet** — opens a read-only buffer covering modes, survival
  commands, search, code intelligence, git, and clipboard; press `q` to close
- **vim-tmux-navigator** plugin — `Ctrl+h/j/k/l` navigates seamlessly across Vim
  splits and tmux panes without a prefix key
- **`install.sh` tmux step** — detects tmux and optionally appends the four
  navigator `bind-key` lines to `~/.tmux.conf`; warns about `C-l`/screen-clear tradeoff
- **`install.sh` survival guide** — post-install output now shows the 4 essential
  commands for first-time Vim users, plus the `stty -ixon` advisory
- **QUICKSTART.md Step 0** — new first section explaining Vim modes (Normal/Insert/Visual)
  and 4 survival commands; makes the guide usable by users who have never opened Vim
- **`let b:ale_enabled = 0`** in `LargeFileSettings()` — ALE no longer spawns
  linter subprocesses for files over 10 MB

### Changed

- **ALE lint triggers** — `ale_lint_on_text_changed` changed from `'never'` to `'normal'`;
  `ale_lint_on_insert_leave` and `ale_lint_on_enter` changed from `0` to `1` — diagnostics
  now refresh on buffer enter and after edits settle in normal mode
- **`<C-h/j/k/l>` manual maps removed** — vim-tmux-navigator owns these keys at
  plugin load time; the previous hand-rolled `<C-W>` maps were unreachable dead code
- **`<leader>pp` paste-mode toggle removed** — functionally identical to the existing
  `F2` pastetoggle; its presence caused a 500 ms delay on every `<leader>p` paste

### Fixed

- **ALE navigation direction reversed** — `[e` now correctly calls `ALEPrevious`
  and `]e` calls `ALENext`, matching the vim-unimpaired `[`/`]` convention
- **`<leader>rG` regex metacharacter bug** — without `-F`, characters like `.` `*`
  `(` in the cursor word were treated as regex, producing incorrect matches

---

## [1.0.0] - 2026-03-29

First stable release. Full-stack engineering environment out of the box — automatic
installation, tiered LSP, TTY fallback, and coverage for 14 languages.

### Added
- **Arch Linux support** in `install.sh` — pacman branch for all system tools
- **`hadolint`** added to system tools installation (Dockerfile linting)
- **`staticcheck`** added to Go tools (replaces archived `golint`)
- **`yamllint`** added to pip tools (YAML linting)
- **`coc-settings.json`** — configures `marksman` as Markdown LSP for CoC via
  `languageserver` entry; symlinked automatically by `install.sh`
- **pip3 bootstrap** in `install.sh` — auto-installs pip3 when python3 is present
  but pip3 is absent (common on Ubuntu minimal images)
- **9 named augroups** in `.vimrc` — all loose `autocmd` statements now wrapped
  with `autocmd!` to prevent doubling on `:source $MYVIMRC`:
  `ChopstickTabHistory`, `ChopstickResize`, `ChopstickStdin`, `CocHighlight`,
  `ChopstickCleanup`, `ChopstickFiletype`, `ChopstickTTYLargeFile`,
  `ChopstickWhichKey`, `ChopstickStartify`
- **TTY-safe plugin install** — `vim +PlugInstall +qall </dev/null` prevents
  Vim from blocking in non-interactive/piped environments

### Changed
- SQL tooling unified to **`sqlfluff`** (pip) — `sqlfmt` removed from npm section
- Go linter changed from `golint` (archived 2023) to **`staticcheck`**
- Markdown LSP changed from broken `coc-marksman` (npm) to **`marksman`** binary
  configured via `coc-settings.json`

### Fixed
- **vim-go startup hang** on Arch Linux — removed `:GoUpdateBinaries` post-install
  hook; set `g:go_gopls_enabled = 0` to prevent conflict with `coc-go`
- **E495 errors** (`<afile>` in special buffers) — all `<afile>` usages guarded
  with `!empty(expand('<afile>'))` and `empty(&buftype)` checks
- **`g:go_def_mode` conflict** — now conditional: uses `gopls` when CoC active,
  `godef` when vim-lsp active (avoids error when gopls is disabled)
- **vim startup UX** — NERDTree + Startify layout for `vim .` and bare `vim`
- **`coc-marksman` silent failure** — package does not exist on npm; replaced with
  native `languageserver` configuration in `coc-settings.json`
- **CoC startup warning** in no-node environments — `g:coc_start_at_startup = 0`
  and `g:coc_disable_startup_warning = 1` set when `g:use_coc = 0`

---

## [0.9.0] - 2026-02-21

### Added
- **Full-stack language coverage** — LSP, lint, and format for: Python,
  JavaScript, TypeScript, Go, Rust, Shell, YAML, HTML, CSS/SCSS, Less,
  JSON, Markdown, SQL, Dockerfile
- **`install.sh` overhaul** — automated installation of system tools, npm tools,
  pip tools, Go tools, and CoC language server extensions with platform detection
  and interactive prompts; `--yes` flag for non-interactive mode
- **vim-startify** startup screen with dynamic header (version, cwd, git branch)
- **vim-which-key** keybinding popup on `,` + 500ms pause
- **Startup layout** — `vim .` opens NERDTree left + Startify right; bare `vim`
  opens Startify with NERDTree alongside
- **Session management** via vim-obsession + vim-prosession
- **Large file handling** — syntax and undo disabled for files > 10 MB
- **Project-local config** — `.vimrc` in project root auto-loaded via `set exrc`
- **Persistent undo** — `~/.vim/.undo/` with `undolevels=1000`

### Changed
- Tiered LSP backend: CoC (Node.js) preferred, vim-lsp (no Node.js) as fallback
- All CoC and vim-lsp keybindings unified (`gd`, `K`, `[g`/`]g`, `,rn`, `,ca`)
- ALE `fix_on_save` disabled when vim-lsp active (prevents double-format)
- NERDTree autocmd wrapped in `augroup NERDTreeAutoClose`

### Fixed
- Multiple leader key conflicts resolved (`,ad`, `,cd`, `,cp`, `,sp`, `,t`)
- CtrlP removed (redundant with FZF)
- Duplicate `set` options cleaned up
- `<leader>A` dead mapping (no alternate-file plugin) removed

---

## [0.1.0] - 2024

Initial release — base Vim configuration with vim-plug, basic plugins, and
TTY/non-TTY detection.