feat: add Debian as a third supported platform#41
Merged
Conversation
Treat Debian (stable, trixie / 13+) as first-class alongside macOS and Arch. All servers run Debian; this closes the gap that surfaced when nvim-treesitter's main branch failed to build parsers without a tree-sitter CLI on a node-free Debian host. Platform contract: - cross-platform rule, AGENTS.md (incl. status block), CLAUDE.md status block all name Debian and treat it separately (apt; /etc/debian_version detection ordered after /etc/arch-release). Packages / tasks / scripts: - packages/debian/packages.txt (apt list; bat->batcat, fd->fdfind; go-task and oh-my-posh installed out-of-band). - deps:debian task (print-only) and Debian hints in the deps:check:* scripts. - tree-sitter CLI and (if apt's neovim < 0.11) neovim itself install from prebuilt binaries, node-free, no ABI drift. - empty stow/debian/ package dir for parity with macos/ and arch/. Docs: - ADR 0053 records the decision and the apt-vs-brew rationale. - packages-setup guide and nvim README gain Debian sections. - MkDocs site updated across platform-bearing pages. Deferred (documented honestly, not claimed working): the zsh per-OS layer (no debian.zsh), task detect, and os-maintenance.sh apt branch still target macOS/Arch only.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds Debian (stable, trixie / 13+) as a first-class supported platform alongside macOS and Arch. All servers run Debian. This closes the gap that surfaced when
nvim-treesitter'smainbranch failed to build parsers (ENOENT 'tree-sitter') on a node-free Debian host.What changed
Platform contract
cross-platform.mdrule,AGENTS.md(incl. status block),CLAUDE.mdstatus block — Debian named and treated separately (apt;/etc/debian_versiondetection ordered after/etc/arch-release).Packages / tasks / scripts
packages/debian/packages.txt— apt list (quirks:bat→batcat,fd→fdfind;go-task/oh-my-poshout-of-band).deps:debiantask (print-only) + Debian hints indeps:check:*scripts.< 0.11— install from prebuilt binaries (node-free, no ABI drift).stow/debian/for parity withmacos/andarch/.Docs
0053records the decision + apt-vs-brew rationale.Deferred (documented, not claimed working)
The runtime per-OS layer still targets macOS/Arch only — flagged honestly in the docs rather than overstated:
debian.zsh)task detectos-maintenance.shapt branchNotes
neovim,eza) not verified live; docs handle either outcome.