📜 Universal Vim Configuration

Configuração clássica, resiliente e de alta portabilidade do editor Vim com Vim-Plug e tema CodeDark.

---

🧭 Visão Geral

Este repositório contém a configuração oficial do Vim de Gabriel Frigo, integrando a Suíte de Editores do Universal Environment. Projetado com foco em:

• Onipresença UNIX: Funciona em qualquer terminal, servidor headless ou estação de trabalho gráfica.
• Fail-Safe Startup: Detecção dinâmica de runtimepath e inicialização limpa sem warnings caso plugins externos ainda não estejam instalados.
• Ecossistema Vim-Plug: Plugins de navegação rápida (FZF, NERDTree, Surround, Visual-Multi).
• Tema CodeDark: Visual escuro estilo VS Code com fallback gracioso para o tema padrão.

---

📁 Catálogo da Estrutura

Arquivo / Diretório	Descrição
TODO.md	Roadmap estratégico, matriz de status e backlog de evolução
vim.sh	Interface unificada de componente (CLI para test, doctor, update)
vimrc	Configuração principal do Vim com opções, plugins e atalhos
autoload/plug.vim	Gerenciador de plugins Vim-Plug embutido
AGENTS.md	Briefing arquitetural para agentes de inteligência artificial
PRINCIPLES.md	Os 18 Princípios de Engenharia UNIX + Clean Code
ENVIRONMENT.md	Manifesto do ecossistema Universal Environment

---

🚀 Instalação e Uso Rápido

Opção A — Modo Versionado (Recomendado para Manutenção)

Clona o repositório diretamente no destino canônico com controle de versão Git ativo, permitindo atualizações automáticas contínuas via uped ou git pull.

🐧 Unix (Linux, FreeBSD, macOS)

git clone "https://github.com/GabrielFrigo4/vim.git" "${HOME}/.vim"
ln -sf "${HOME}/.vim/vimrc" "${HOME}/.vimrc"

🪟 Windows (PowerShell Nativo)

git clone "https://github.com/GabrielFrigo4/vim.git" "$HOME\vimfiles"

🪟 Windows (MSYS2 / Git Bash)

git clone "https://github.com/GabrielFrigo4/vim.git" "${HOME}/.vim"
ln -sf "${HOME}/.vim/vimrc" "${HOME}/.vimrc"

---

Opção B — Modo Standalone Limpo (Zero-Bloat / Produção)

Tip

Filosofia Zero-Bloat: Ideal para servidores, contêineres ou computadores de terceiros onde o controle de versão Git e artefatos de desenvolvimento não são necessários. Clona a árvore rasa (--depth=1) e remove metadados (.git*, .agents, *.md), deixando apenas a configuração estritamente executável.

🐧 Unix (Linux, FreeBSD, macOS & MSYS2)

git clone --depth=1 "https://github.com/GabrielFrigo4/vim.git" "${HOME}/.vim" && \
  ln -sf "${HOME}/.vim/vimrc" "${HOME}/.vimrc" && \
  rm -rf "${HOME}/.vim/.git"* "${HOME}/.vim/.agents" "${HOME}/.vim/"*.md

🪟 Windows (PowerShell)

git clone --depth=1 "https://github.com/GabrielFrigo4/vim.git" "$HOME\vimfiles"
Remove-Item -Recurse -Force "$HOME\vimfiles\.git*", "$HOME\vimfiles\.agents", "$HOME\vimfiles\*.md" -ErrorAction SilentlyContinue

---

⚙️ Integração com o Universal Environment

Quando operado a partir do Universal Environment:

Atualizar a suíte de editores com o upstream

make uped

Implantar o repositório no destino canônico (~/vimfiles e ~/.vimrc)

make deploy

---

🔌 Instalar Plugins e Validação

Abra o Vim e execute:

:PlugInstall

Ou valide em modo headless via CLI:

vim -u vimrc -es -c "quit"