@sebastienrousseau/dotfiles 0.2.481 → 0.2.499

package/docs/NEOVIM_IDE_GUIDE.md

@@ -1,52 +0,0 @@
-# Neovim
-
-## Discover
-
-### 1. Modern Core
-- **Installation**: Uses Neovim Nightly (v0.11+) for the latest features and plugin compatibility.
-- **Configuration**: A modular and lazy-loaded configuration based on `lazy.nvim`.
-- **UI**: A beautiful and functional UI with a dashboard, status line, buffer line, and file explorer.
-- **LSP**: Full LSP support for diagnostics, code actions, and more, managed by `mason.nvim`.
-
-### 2. Language Support
-- **Rust**: Out-of-the-box support for Rust development with `rustaceanvim`.
-- **Python**: Full support for Python development with `basedpyright`, `ruff`, and `venv-selector`.
-- **Web**: Support for web development with `prettier` and `eslint`.
-
-### 3. AI Integration
-- **Copilot**: `copilot.lua` for code completion. Run `:Copilot auth` to sign in.
-- **Copilot Chat**: AI sidebar for asking questions and getting help (`<leader>cc`).
-
-### 4. VS Code Parity
-- **Problem Panel**: `trouble.nvim` for a VS Code-like problems panel (`<leader>xx`).
-- **Search & Replace**: `nvim-spectre` for project-wide search and replace (`<leader>S`).
-- **Auto-Pairs**: Automatically closes brackets and pairs.
-- **TODOs**: Highlights `TODO` and `FIXME` comments.
-- **Session**: Auto-restores your last session.
-
-## Keybindings
-| Key | Action |
-| --- | --- |
-| `<Space>ff` | Find Files |
-| `<Space>fg` | Grep (Search) text |
-| `<Space>fb` | File browser |
-| `<Space>fp` | Projects |
-| `<Space>e` | Toggle File Explorer |
-| `<Space>a` | Add file to Harpoon |
-| `<Ctrl>e` | Open Harpoon menu |
-| `gd` | Go to Definition |
-| `gr` | Go to References |
-| `<leader>ca` | Code actions |
-| `<leader>cf` | Format code |
-| `<leader>cr` | Rename symbol |
-| `<leader>tt` | Toggle terminal |
-| `<leader>tn` | Test nearest |
-| `<leader>tf` | Test file |
-| `<leader>ts` | Test suite |
-| `<F5>` | Continue (Debug) |
-| `<F10>` | Step over (Debug) |
-| `<F11>` | Step into (Debug) |
-| `<F12>` | Step out (Debug) |
-| `<leader>cc` | Toggle Copilot Chat |
-| `<leader>xx` | Toggle Diagnostics (Trouble) |
-| `<leader>S` | Toggle Spectre (Search/Replace) |

package/docs/README.md

@@ -1,269 +0,0 @@
-# Dotfiles Documentation
-
-<div align="center">
-
-**A modern, cross-platform shell environment built for developers.**
-
-[Quick Start](#quick-start) · [Features](#features) · [Architecture](#architecture) · [Security](#security) · [Contributing](#contributing)
-
-</div>
-
----
-
-## Overview
-
-Welcome to the dotfiles documentation. This guide will help you install, configure, and customize your development environment across macOS, Linux, and WSL.
-
-### What You'll Get
-
-| Feature | Description |
-|---------|-------------|
-| 🚀 **Fast Shell** | Zsh with lazy loading, <500ms startup |
-| 🔧 **Modern Tools** | Neovim, tmux, starship, fzf, ripgrep |
-| 🔐 **Security First** | Encrypted secrets, credential management |
-| 🎨 **Beautiful UI** | Nerd Fonts, themes, consistent styling |
-| 📦 **Cross-Platform** | macOS, Linux, WSL2 support |
-
----
-
-## Table of Contents
-
-### Getting Started
-- [Installation Guide](INSTALL.md) — Set up your environment in minutes
-- [Walkthrough](WALKTHROUGH.md) — Interactive tour of key features
-- [Features Overview](FEATURES.md) — Complete feature list
-
-### Core Documentation
-- [Architecture](ARCHITECTURE.md) — System design and structure
-- [Operations Guide](OPERATIONS.md) — Daily usage and maintenance
-- [Troubleshooting](TROUBLESHOOTING.md) — Common issues and solutions
-
-### Configuration
-- [Aliases Reference](ALIASES.md) — Shell aliases and shortcuts
-- [Keybindings](KEYS.md) — Keyboard shortcuts catalog
-- [Tools Reference](TOOLS.md) — Installed tools and utilities
-- [Utilities](UTILS.md) — Helper scripts and functions
-
-### Customization
-- [Fonts Guide](FONTS.md) — Nerd Fonts installation
-- [Screenshots](SCREENSHOTS.md) — Visual gallery
-- [Neovim IDE Guide](NEOVIM_IDE_GUIDE.md) — Editor configuration
-
-### Security
-- [Security Overview](SECURITY.md) — Security model and practices
-- [Security Checklist](SECURITY_CHECKLIST.md) — Hardening guide
-- [Secrets Management](SECRETS.md) — Encrypted credentials
-
-### Development
-- [Testing Guide](TESTING.md) — Test framework and coverage
-- [Compliance](COMPLIANCE.md) — Standards and policies
-- [Architecture Decisions](adr/) — ADRs for key decisions
-
-### Platform-Specific
-- [WSL2 + Nix Guide](WSL2_NIX_TROUBLESHOOTING.md) — Windows Subsystem for Linux
-
-### Reference
-- [Roadmap](ROADMAP.md) — Future plans and priorities
-- [Legacy Roadmap](LEGACY_ROADMAP.md) — Historical context
-
----
-
-## Quick Start
-
-### Prerequisites
-
-- macOS 12+, Ubuntu 22.04+, or Windows 11 with WSL2
-- Git 2.30+
-- curl or wget
-
-### Installation
-
-```bash
-# One-line install
-curl -fsSL https://raw.githubusercontent.com/sebastienrousseau/dotfiles/master/install.sh | bash
-```
-
-Or clone and install manually:
-
-```bash
-git clone https://github.com/sebastienrousseau/dotfiles.git ~/.dotfiles
-cd ~/.dotfiles && ./install.sh
-```
-
-### First Steps
-
-After installation, run these commands to explore:
-
-```bash
-dot help          # Show all available commands
-dot doctor        # Check system health
-dot learn         # Interactive tour
-dot keys          # View keybindings
-```
-
----
-
-## Features
-
-### Shell Environment
-
-The shell configuration provides a fast, feature-rich experience:
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Startup Time: <500ms  │  Plugin Manager: Zinit            │
-│  Prompt: Starship      │  Completions: Lazy-loaded         │
-│  History: Shared       │  Syntax: fast-syntax-highlighting │
-└─────────────────────────────────────────────────────────────┘
-```
-
-**Key Features:**
-- Intelligent command suggestions with autosuggestions
-- Fuzzy finding with fzf for files, history, and git
-- Git integration with delta for beautiful diffs
-- Directory jumping with zoxide
-
-### Development Tools
-
-Pre-configured toolchains for modern development:
-
-| Language | Tools |
-|----------|-------|
-| **Rust** | rustup, cargo, clippy, rustfmt |
-| **Go** | go, golangci-lint |
-| **Node.js** | nvm, npm, pnpm |
-| **Python** | pyenv, pipx, uv |
-
-### AI Integration
-
-Built-in support for AI coding assistants:
-
-- **aider** — AI pair programming
-- **Claude** — Anthropic's assistant
-- **GitHub Copilot** — Code suggestions
-- **git-ai-commit** — AI-powered commit messages
-
----
-
-## Architecture
-
-The dotfiles follow a modular architecture:
-
-```
-~/.dotfiles/
-├── dot_config/           # XDG config files
-│   ├── nvim/             # Neovim configuration
-│   ├── zsh/              # Zsh configuration layers
-│   └── git/              # Git configuration
-├── dot_local/bin/        # User scripts and tools
-├── install/              # Installation scripts
-│   └── provision/        # Tool provisioning
-├── scripts/              # Operational scripts
-│   ├── dot/commands/     # CLI command modules
-│   ├── diagnostics/      # Health checks
-│   ├── security/         # Security tools
-│   └── tuning/           # Performance tuning
-└── docs/                 # Documentation (you are here)
-```
-
-### Shell Layer System
-
-Zsh configuration uses numbered layers for predictable loading:
-
-| Range | Purpose | Examples |
-|-------|---------|----------|
-| 00-19 | Core | Environment, history, options |
-| 20-49 | Middleware | Zinit, completions, plugins |
-| 50-89 | Toolchain | Languages, package managers |
-| 90-99 | UX | Prompt, aliases, keybindings |
-
-### CLI Architecture
-
-The `dot` CLI uses modular command dispatch:
-
-```bash
-dot <command> [args]
-     │
-     ├── core.sh        # apply, sync, update, diff
-     ├── diagnostics.sh # doctor, heal, benchmark
-     ├── tools.sh       # tools, new, packages
-     ├── appearance.sh  # theme, fonts, wallpaper
-     ├── secrets.sh     # secrets-init, secrets
-     ├── security.sh    # firewall, backup, encrypt
-     └── meta.sh        # upgrade, docs, learn
-```
-
----
-
-## Security
-
-Security is a core principle, not an afterthought.
-
-### Secrets Management
-
-```bash
-dot secrets-init    # Initialize age encryption
-dot secrets         # Edit encrypted secrets
-dot ssh-key         # Encrypt SSH keys
-```
-
-Secrets are encrypted with [age](https://age-encryption.org/) and never stored in plaintext.
-
-### Credential Management
-
-Supported credential stores:
-- **macOS** — Keychain integration
-- **Linux** — libsecret / GNOME Keyring
-- **Git** — git-credential-manager
-
-### Security Hardening (Opt-in)
-
-```bash
-dot firewall      # Configure firewall rules
-dot telemetry     # Disable OS telemetry
-dot dns-doh       # Enable DNS-over-HTTPS
-dot encrypt-check # Verify disk encryption
-```
-
-All security modifications require explicit consent.
-
----
-
-## Contributing
-
-We welcome contributions! Please see our guidelines:
-
-1. **Fork** the repository
-2. **Create** a feature branch
-3. **Test** your changes with `dot doctor`
-4. **Submit** a pull request
-
-### Code Style
-
-- Shell scripts: Follow ShellCheck recommendations
-- Templates: Use `.chezmoitemplates/` for reusable logic
-- Documentation: Use UPPERCASE.md naming convention
-
-### Testing
-
-```bash
-./scripts/tests/framework/test_runner.sh        # Unit tests
-RUN_INTEGRATION=1 ./scripts/tests/framework/test_runner.sh  # Integration
-```
-
----
-
-## Support
-
-- **Issues**: [GitHub Issues](https://github.com/sebastienrousseau/dotfiles/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/sebastienrousseau/dotfiles/discussions)
-
----
-
-<div align="center">
-
-**[Back to Top](#dotfiles-documentation)**
-
-Made with ❤️ by [Sebastien Rousseau](https://github.com/sebastienrousseau)
-
-</div>

package/docs/REPO_AUDIT.md

@@ -1,23 +0,0 @@
-# Repo Audit
-
-## Source of truth
-- `~/.dotfiles` (chezmoi source directory)
-
-## Key directories
-- `.chezmoitemplates/` - templated aliases, functions, paths
-- `dot_config/` - configs mapped into `~/.config`
-- `dot_local/` - binaries and local data (e.g., `dot` CLI)
-- `scripts/` - diagnostics, tests, tooling
-- `tests/` - sandbox Dockerfile
-- `nix/` - optional Nix toolchain
-
-## Notable dependencies
-- `chezmoi`
-- `zsh`, `starship`
-- `neovim`
-- `ripgrep`, `fd`, `bat`, `fzf`, `zoxide`
-- `lazygit`
-
-## Notes
-- Repo-only files excluded via `.chezmoiignore`.
-- Secrets are handled via `age` + `dot secrets` (see `docs/SECRETS.md`).

package/docs/SCREENSHOTS.md

@@ -1,116 +0,0 @@
-# Screenshots gallery
-
-See how the dotfiles look across different themes and configurations.
-
-## Theme gallery
-
-### Catppuccin Mocha (default)
-
-The default theme, Catppuccin Mocha, gives you a dark palette with warm, muted colors.
-
-```
-Terminal: Ghostty / WezTerm / Alacritty
-Font: JetBrains Mono Nerd Font
-Theme: Catppuccin Mocha
-```
-
-Key colors:
-- Background: `#1e1e2e`
-- Foreground: `#cdd6f4`
-- Accent Blue: `#89b4fa`
-- Accent Red: `#f38ba8`
-
-### Catppuccin Latte (light)
-
-A light theme option for daytime use.
-
-```
-Terminal: Ghostty / WezTerm / Alacritty
-Font: JetBrains Mono Nerd Font
-Theme: Catppuccin Latte
-```
-
-Key colors:
-- Background: `#eff1f5`
-- Foreground: `#4c4f69`
-- Accent Blue: `#1e66f5`
-- Accent Red: `#d20f39`
-
-## Terminal configurations
-
-### Ghostty
-
-Modern, native terminal with GPU acceleration.
-
-Features:
-- Native macOS integration
-- Fast rendering
-- Ligature support
-- Custom key bindings
-
-### WezTerm
-
-Cross-platform terminal with Lua configuration.
-
-Features:
-- GPU acceleration
-- Multiple windows/tabs
-- Hyperlinks
-- Image protocol support
-
-### Alacritty
-
-Minimal, fast terminal.
-
-Features:
-- Fast rendering
-- Simple YAML config
-- Vi mode
-- Cross-platform
-
-### Kitty
-
-Feature-rich terminal.
-
-Features:
-- GPU rendering
-- Ligatures
-- Image support
-- Keyboard protocol
-
-## Prompt (Starship)
-
-Your Starship prompt displays:
-- Current directory
-- Git branch and status
-- Language versions (when relevant)
-- Command duration
-- Exit status
-
-## Neovim
-
-Your Neovim configuration includes:
-- Catppuccin theme
-- Treesitter syntax highlighting
-- LSP integration
-- Telescope fuzzy finder
-- File tree (nvim-tree)
-
-## tmux
-
-Your tmux status bar displays:
-- Session name
-- Current window
-- Host name
-- Date and time
-
-## Adding screenshots
-
-To contribute screenshots:
-
-1. Take a screenshot of your terminal
-2. Save as PNG in `docs/themes/`
-3. Add reference in this file
-4. Submit a PR
-
-Recommended screenshot size: 1920x1080 or 2560x1440

package/docs/SECRETS.md

@@ -1,76 +0,0 @@
-# Secrets
-
-You can encrypt secrets using `age` with `chezmoi`.
-
-## Get started
-
-```bash
-dot secrets-init
-```
-
-The command creates `~/.config/chezmoi/key.txt` and prints your public key. It also updates `~/.config/chezmoi/chezmoi.toml` with the `age` backend settings.
-
-> [!IMPORTANT]
-> Verify that `age` is installed before running this command. You can install it through `brew`, `apt`, or your preferred toolchain.
-
-## Enable encryption
-
-Edit `~/.config/chezmoi/chezmoi.toml` (local only):
-
-```toml
-encryption = "age"
-
-[age]
-identity = "~/.config/chezmoi/key.txt"
-recipient = "age1..."
-```
-
-You can also re-run:
-
-```bash
-chezmoi init --apply --promptDefaults
-```
-
-## Edit secrets
-
-```bash
-dot secrets
-```
-
-The command opens `~/.config/chezmoi/encrypted_secrets.age` for editing and applies changes when you save.
-
-## Create secrets
-
-```bash
-dot secrets-create
-```
-
-Then edit:
-
-```bash
-dot secrets
-```
-
-## Encrypt an SSH key
-
-```bash
-dot ssh-key ~/.ssh/id_ed25519
-```
-
-The command creates a local encrypted file at:
-`~/.config/chezmoi/encrypted_id_ed25519.age`
-
-If you want it tracked (encrypted) in your dotfiles, run:
-
-```bash
-chezmoi add --encrypt ~/.config/chezmoi/encrypted_id_ed25519.age
-```
-
-## Important notes
-
-> [!WARNING]
-> Keep `~/.config/chezmoi/key.txt` private. Never commit this file to a public repository.
-
-- You can share the public key freely for encrypting data.
-- Consider rotating keys yearly (or after any potential leak).
-  To rotate: generate a new key, update `chezmoi.toml`, re-encrypt your secrets, and delete the old key.

package/docs/SECURITY.md

@@ -1,30 +0,0 @@
-# Security
-
-Learn how Dotfiles handles security and system modifications.
-
-## Principles
-
-- **Opt-In Only**: No hardening is applied unless the `DOTFILES_` variables are set to `1`.
-- **Local Logging**: Actions are logged to `~/.local/share/dotfiles.log`. No telemetry.
-- **No Hidden Sudo**: Sudo is only requested for system managers (apt, etc) and never cached indefinitely.
-
-## Hardening
-
-| Feature | Env Var | Action (macOS) | Action (Linux) |
-|---|---|---|---|
-| Firewall | `DOTFILES_FIREWALL` | Enables `socketfilterfw` + Stealth Mode | Configures UFW |
-| Telemetry | `DOTFILES_TELEMETRY` | Disables Diagnostic plists | Disables `whoopsie`/`apport` |
-| DNS-over-HTTPS | `DOTFILES_DOH` | Browser-level settings | Configures `resolvectl` |
-| Idle Security | `DOTFILES_LOCK` | Sets screensaver idle time | Sets GNOME/KDE idle-delay |
-
-## Secrets
-
-Dotfiles uses **age** for encryption.
-
-- **Initialization**: `dot secrets-init` creates a key at `~/.config/chezmoi/key.txt`.
-- **Storage**: Secrets are stored as `.age` encrypted files.
-- **Protection**: Private keys are never committed to the repo.
-
-## Report an issue
-
-If you discover a security vulnerability, please do not open a public issue. Follow the instructions in the Security Policy.