remove oil and plan neovim 0.12 upgrade

AGENTS.md

@@ -8,7 +8,7 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 - Modern Lua-first config; avoid Vimscript unless explicitly requested.
 - Keep it minimal, fast, and maintainable.
 - Base plugin management on `lazy.nvim` with modular plugin specs.
-- Support Telescope navigation, netrw for file browsing/preview, Oil.nvim for file operations, LSP, Treesitter, Copilot, and sane UX defaults.
+- Support Telescope navigation, netrw for tree browsing, previews, and file operations, LSP, Treesitter, Copilot, and sane UX defaults.
 - Native project-local configuration via `exrc` + `secure` (no external config plugins).
 
 ## Do Not Reintroduce
@@ -40,7 +40,6 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
         ├── cmp.lua
         ├── lsp.lua
         ├── copilot.lua
-        ├── oil.lua
         ├── ufo.lua
         ├── gitsigns.lua
         ├── conform.lua
@@ -82,7 +81,7 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 
 ## Required Plugin Categories
 - Core: `nvim-lspconfig`, `nvim-cmp`, `cmp-nvim-lsp`, `cmp-buffer`, `cmp-path`, `LuaSnip`.
-- Navigation: `telescope.nvim` + `telescope-fzf-native.nvim`, `oil.nvim`.
+- Navigation: `telescope.nvim` + `telescope-fzf-native.nvim`; netrw is the sole file explorer.
 - Treesitter: `nvim-treesitter`, `nvim-treesitter-textobjects`, `nvim-ts-autotag`.
 - UX/Editing: `Comment.nvim`, `nvim-surround`, `nvim-autopairs`, `indent-blankline.nvim`, `nvim-ufo`, `undotree`.
 - Git: `gitsigns.nvim`.
@@ -93,7 +92,7 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 ## Workflow Requirements to Preserve
 - Netrw for visual context and project structure browsing (tree view, preview splits).
 - Telescope for fuzzy finding (files, grep, buffers, LSP symbols).
-- Oil.nvim for file manipulation (handles buffer sync on rename/move/delete).
+- Netrw for file manipulation as well as browsing, preserving the same workflow on remote systems.
 - LSP for navigation (gd, gr, K, etc.).
 - Heavy HTML/PHP/JS/Markdown usage (WordPress plugin dev) — prioritize these languages in LSP/Treesitter.
 - Format-on-save with toggle capability.
@@ -110,7 +109,7 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 ## Current Status (Phase 12 In Progress)
 - ✅ Phase 1-2: Archive legacy, bootstrap lazy.nvim
 - ✅ Phase 3: Core editing & LSP (native exrc + vim.lsp.config migration complete)
-- ✅ Phase 4: Navigation (Telescope, netrw, Oil.nvim)
+- ✅ Phase 4: Navigation (Telescope and netrw)
 - ✅ Phase 5: Treesitter (parsers, textobjects, autotag)
 - ✅ Phase 6: UX/Editing (Comment, surround, autopairs, indent guides, UFO, undotree)
 - ✅ Phase 7: Git integration (Gitsigns)
@@ -119,6 +118,8 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 - ✅ Phase 10: Migrate kept behaviors (abbreviations, templates, custom Treesitter queries)
 - ✅ Phase 11: Modern Paper Tonic colorscheme
 - ⏳ Phase 12: Cleanup and validation (repository cleanup and automated checks complete; interactive workflow checks remain)
+- 📋 Phase 13: Controlled Neovim 0.12.6 upgrade (planned)
+- 📋 Phase 14: Netrw live previews and directory summaries (planned after upgrade)
 
 ## Migration Notes
 - Do not edit legacy Vimscript files except to extract settings to Lua. Keep them intact until migration completes.
@@ -129,7 +130,7 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 
 ## Validation
 - Ensure Neovim starts without errors and with minimal startup time.
-- Verify Telescope navigation, netrw browsing, Oil.nvim file operations, LSP basics, and completion.
+- Verify Telescope navigation, netrw browsing and file operations, LSP basics, and completion.
 - Keep plugin count tight; remove anything unused.
 
 ## Key Decisions & Architecture
@@ -145,12 +146,12 @@ This repository is being migrated to a modern, minimal Neovim setup driven by Lu
 ### Navigation Strategy
 - **netrw**: Visual context, tree view, preview splits (horizontal 50/50 below)
 - **Telescope**: Fuzzy finding (files, grep, buffers, LSP symbols)
-- **Oil.nvim**: File manipulation (handles buffer sync on rename/move/delete)
+- **netrw**: Sole file explorer for tree browsing, previews, and file operations
 - **PHP gf enhancement**: Custom `includeexpr` in `after/ftplugin/php.lua` for WordPress/PHP patterns
 
 ### Formatting & Linting
-- **Formatters**: prettier, phpcbf, stylua, black (project-local → Mason → global)
-- **Linters**: eslint_d, phpcs, markdownlint, ruff (via nvim-lint)
+- **Formatters**: prettier, phpcbf, stylua, ruff_format (project-local → Mason → global)
+- **Linters**: eslint_d, phpcs, markdownlint, plus Ruff through LSP
 - **Format-on-save**: Enabled by default, toggle with `<leader>lt`
 - **Philosophy**: Formatters are source of truth; Neovim settings match formatter rules per filetype