Modernize 2026

.github/link-check-config.json

@@ -0,0 +1,19 @@
+{
+  "timeout": "8s",
+  "retryOn429": true,
+  "retryCount": 2,
+  "fallbackRetryDelay": "30s",
+  "aliveStatusCodes": [200, 206],
+  "ignorePatterns": [
+    {
+      "pattern": "^https://github.com/[^/]+/[^/]+$",
+      "comment": "Allow main GitHub repo pages without files"
+    },
+    {
+      "pattern": "^mailto:",
+      "comment": "Skip email links"
+    }
+  ],
+  "replacementPatterns": [],
+  "httpHeaders": []
+}

.github/workflows/docs-validation.yml

@@ -0,0 +1,138 @@
+name: Documentation Validation
+
+on:
+  push:
+    branches: [main, modernize-2026]
+    paths:
+      - "*.md"
+      - ".github/workflows/docs-validation.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "*.md"
+
+jobs:
+  markdown:
+    name: Markdown Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install markdownlint
+        run: npm install -g markdownlint-cli
+
+      - name: Lint Markdown
+        run: |
+          echo "Linting markdown files..."
+          markdownlint '*.md'
+          echo "✓ All markdown files passed linting"
+
+  links:
+    name: Link Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install markdown-link-check
+        run: npm install -g markdown-link-check
+
+      - name: Check Links
+        run: |
+          echo "Checking internal links..."
+          FAILED=0
+          for file in *.md; do
+            echo "Checking $file..."
+            if ! markdown-link-check -q -c .github/link-check-config.json "$file"; then
+              FAILED=1
+            fi
+          done
+          if [ $FAILED -eq 1 ]; then
+            echo "❌ Some links are broken"
+            exit 1
+          fi
+
+  files:
+    name: File Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check required files exist
+        run: |
+          echo "Checking for required documentation files..."
+
+          files=(
+            "README.md"
+            "CHANGELOG.md"
+            "CONTRIBUTING.md"
+            "MODERNIZATION_2026.md"
+            "PLUGIN_AUDIT_2026.md"
+          )
+
+          for file in "${files[@]}"; do
+            if [ ! -f "$file" ]; then
+              echo "❌ Missing required file: $file"
+              exit 1
+            fi
+            echo "✓ $file exists"
+          done
+
+      - name: Check README freshness
+        run: |
+          echo "Verifying README is current..."
+
+          # Check that README mentions 0.5 (current version)
+          grep -q "0.5\|2026" README.md || echo "⚠️  README may need version update"
+
+          # Check that README mentions 0.10.0 requirement
+          grep -q "0.10" README.md || echo "⚠️  README may need Neovim version update"
+
+          echo "✓ README appears current"
+
+      - name: Check CHANGELOG updated
+        run: |
+          echo "Verifying CHANGELOG is up-to-date..."
+
+          # Check that CHANGELOG has recent entries
+          grep -q "2026" CHANGELOG.md || echo "⚠️  CHANGELOG may need updating"
+
+          echo "✓ CHANGELOG exists and appears current"
+
+  structure:
+    name: Project Structure
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Verify directory structure
+        run: |
+          echo "Checking project structure..."
+
+          dirs=(
+            "lua"
+            "lua/config"
+            "lua/plugins"
+            "lua/plugins/lsp"
+            ".github/workflows"
+          )
+
+          for dir in "${dirs[@]}"; do
+            if [ ! -d "$dir" ]; then
+              echo "❌ Missing directory: $dir"
+              exit 1
+            fi
+            echo "✓ $dir exists"
+          done
+
+      - name: Count plugins
+        run: |
+          count=$(find lua/plugins -name "*.lua" -type f | wc -l)
+          echo "Total plugin files: $count"
+
+          if [ "$count" -lt 40 ]; then
+            echo "⚠️  Plugin count low: $count"
+          elif [ "$count" -gt 60 ]; then
+            echo "⚠️  Plugin count high: $count (target: 50-55)"
+          else
+            echo "✓ Plugin count is good: $count"
+          fi

.github/workflows/lint-and-format.yml

@@ -0,0 +1,108 @@
+name: Lint & Format Check
+
+on:
+  push:
+    branches: [main, modernize-2026]
+    paths:
+      - "lua/**"
+      - "init.lua"
+      - ".stylua.toml"
+      - ".luacheckrc"
+      - ".github/workflows/lint-and-format.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "lua/**"
+      - "init.lua"
+
+jobs:
+  lint:
+    name: Luacheck Linting
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Lua
+        uses: hishamhm/gh-actions-lua@v10
+        with:
+          luaVersion: 5.1
+
+      - name: Install Luarocks
+        uses: hishamhm/gh-actions-luarocks@v4
+
+      - name: Install Luacheck
+        run: luarocks install luacheck
+
+      - name: Run Luacheck
+        run: luacheck lua/
+
+  format:
+    name: Stylua Format Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@1.75
+
+      - name: Install Stylua
+        run: cargo install stylua --locked
+
+      - name: Check Lua formatting
+        run: stylua --check lua/ init.lua
+
+  plugin-load:
+    name: Plugin Loading Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Neovim
+        uses: rhysd/action-setup-vim@v1
+        with:
+          neovim: true
+          version: v0.10.0
+
+      - name: Check Neovim Version
+        run: nvim --version
+
+      - name: Verify Plugin Files Syntax
+        run: |
+          for file in lua/plugins/*.lua lua/config/*.lua; do
+            nvim --headless -c "exec 'source $file' | exec 'quit'" 2>&1 | grep -i 'error' && echo "Syntax error in $file" && exit 1
+          done
+          echo "✓ All Lua files have valid syntax"
+
+  analyze:
+    name: Code Analysis
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check for deprecated APIs
+        run: |
+          echo "Checking for deprecated vim.loop usage..."
+          if grep -r "vim\.loop" lua/ > /dev/null 2>&1; then
+            echo "❌ Found vim.loop usage (use vim.uv instead)"
+            exit 1
+          else
+            echo "✓ No vim.loop found"
+          fi
+
+          echo "Checking for deprecated requires pattern..."
+          if grep -r "requires =" lua/ > /dev/null 2>&1; then
+            echo "❌ Found 'requires =' (use 'dependencies' instead)"
+            exit 1
+          else
+            echo "✓ No deprecated 'requires =' found"
+          fi
+
+      - name: Check plugin count
+        run: |
+          COUNT=$(find lua/plugins -name "*.lua" -not -path "*/lsp/*" | wc -l)
+          echo "Total plugins: $COUNT"
+          if [ "$COUNT" -gt 60 ]; then
+            echo "⚠️  Plugin count is high: $COUNT (target: 50-55)"
+          else
+            echo "✓ Plugin count is reasonable: $COUNT"
+          fi

.luacheckrc

@@ -0,0 +1,42 @@
+-- OVIWrite Luacheck Configuration
+-- Code linting rules for quality assurance
+
+std = "lua51+vim"
+
+files["lua/plugins"] = {
+  ignore = {
+    "212", -- Unused variable
+    "542", -- Empty statement
+  }
+}
+
+files["lua/config"] = {
+  ignore = {
+    "212", -- Unused variable
+    "542", -- Empty statement
+  }
+}
+
+-- Global Vim/Neovim APIs
+globals = {
+  "vim",
+  "OVERRIDES",
+}
+
+-- Allow standard library
+not_globals = {
+  -- None - allow all standard library
+}
+
+-- Line length (information only, not enforced)
+max_line_length = 100
+
+-- Readability
+self = true  -- Report issues with unused self in methods
+
+-- Don't report errors in certain patterns
+exclude_files = {
+  ".git/",
+  "lazy/",
+  "vendor/",
+}

.stylua.toml

@@ -0,0 +1,40 @@
+-- stylua: ignore file (This is stylua's own configuration)
+-- OVIWrite Lua Code Style Configuration
+
+-- Line length before wrapping
+column_width = 100
+
+-- Use spaces instead of tabs
+indent_type = "Spaces"
+
+-- Number of spaces per indent level
+indent_width = 2
+
+-- Quote style for strings
+quote_style = "AutoPreferDouble"
+
+-- Trailing comma handling
+trailing_comma = "AsNeeded"
+
+-- Function formatting
+function_trailing_comma = false
+
+-- Collapse simple tables/functions
+collapse_simple_tables = true
+collapse_simple_functions = false
+
+-- Handle operator spacing around specific operators
+spaces_around_table_braces = true
+
+-- Comments and documentation
+-- Keep original spacing for comments
+ignore_comments = false
+
+-- Exclude directories from formatting
+exclude = { "tests", ".git" }
+
+-- Wall of stars style comments
+wall_of_stars = false
+
+-- EOF newline
+insert_final_newline = true