Major clean up and improvements to vimwiki compatibility and documentation.

Reviewed-on: #1

development/tests/test-keymaps-vim.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+#
+# development/tests/test-keymaps-vim.sh — Vim counterpart of test-keymaps.sh.
+#
+# Pure-VimL portion only. The LSP-roundtrip keymaps (`<C-Space>`,
+# `=`, `-`, …) talk to the server via vim-lsp's timer-driven async
+# layer, which doesn't fire reliably inside `vim -e -s`. Those have
+# Neovim coverage in development/tests/test-keymaps.lua, exercising the same
+# Lua command layer + server binary.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TMP="$(mktemp -d -t nuwiki-keymap-vim-test-XXXXXX)"
+trap 'rm -rf "$TMP"' EXIT
+
+log() { printf '\033[1;34m[keymap-vim]\033[0m %s\n' "$*"; }
+
+if ! command -v vim >/dev/null 2>&1; then
+  log 'vim not installed — skipping'
+  exit 0
+fi
+
+# Don't need the LSP binary for the pure-VimL cases, but make sure
+# the autoload file `expand('<sfile>')` resolves correctly when the
+# script-load-time plugin_root capture runs.
+
+mkdir -p "$TMP/wiki"
+SEED="$TMP/wiki/index.wiki"
+echo "= seed =" > "$SEED"
+
+VIMRC="$TMP/vimrc"
+cat > "$VIMRC" <<EOF
+set nocompatible
+let &runtimepath = '$REPO_ROOT' . ',' . &runtimepath
+" Enable the opt-in mouse mappings before the ftplugin loads so the
+" harness can assert the full documented mapping surface (doc §6 mouse).
+let g:nuwiki_mouse_mappings = 1
+filetype plugin indent on
+syntax enable
+" ftdetect/nuwiki.vim already maps *.wiki → vimwiki via \`set filetype\`.
+EOF
+
+RESULTS="$TMP/results.txt"
+
+log "running harness…"
+# `</dev/null` so Vim's ex-mode doesn't hang waiting on stdin;
+# `timeout` so a misbehaving script can't stall CI for 30 minutes.
+NUWIKI_KEYMAP_RESULTS="$RESULTS" \
+  timeout 30 vim -e -s -u "$VIMRC" -c "edit $SEED" -c "source $REPO_ROOT/development/tests/test-keymaps-vim.vim" \
+    </dev/null >"$TMP/vim.log" 2>&1 || true
+
+if [[ ! -f "$RESULTS" ]]; then
+  echo 'keymap test harness produced no output' >&2
+  echo '--- vim log ---' >&2
+  cat "$TMP/vim.log" >&2 || true
+  exit 1
+fi
+
+cat "$RESULTS"
+
+if grep -qE '^SUMMARY: [0-9]+ passed, 0 failed' "$RESULTS"; then
+  exit 0
+fi
+exit 1