Merge pull request #257 from Coldaine/chore/migrate-git-hooks

chore: migrate to mise + lint-staged git hooks

Author: Coldaine

.git-hooks/pre-commit-injection-tests

@@ -0,0 +1,14 @@
+{
+  "*.rs": [
+    "cargo fmt --"
+  ],
+  "{package.json,package-lock.json,Cargo.toml,Cargo.lock}": [
+    "mise run check:lockfiles"
+  ],
+  ".github/workflows/*.{yml,yaml}": [
+    "mise run actionlint"
+  ],
+  "*": [
+    "mise run typos"
+  ]
+}

.githooks/pre-commit

@@ -4,17 +4,20 @@
  - Install Rust (stable) and required system dependencies for your platform.
  - Use the provided scripts in `scripts/` to help with local environment setup.
 
-### Developer Git Hooks (optional but recommended)
+### Developer Git Hooks
 
-To reduce the chance of CI failures from formatting, this repository includes a small pre-commit hook that runs `cargo fmt --all` before each commit and blocks the commit if `rustfmt` makes changes. To enable it for your local clone:
+This project uses a "Zero-Latency" git hook standard powered by **[mise](https://mise.jdx.dev)** and **lint-staged**.
 
+### Setup
+1. **Install mise**: `curl https://mise.run | sh` (or see [docs](https://mise.jdx.dev/getting-started.html))
+2. **Install dependencies**: `mise install`
+3. **Activate hooks**: `mise run prepare` (runs automatically on `npm install`)
+
+Hooks will now run automatically on `git commit`. To run manually:
 ```bash
-cd <repo-root>
-./scripts/install-githooks.sh
+mise run pre-commit
 ```
 
-This copies the hooks from `.githooks/` into `.git/hooks/` and makes them executable. You can remove or modify the hook if you want a different behavior.
-
 # ColdVox
 
 > ⚠️ **Internal Alpha** - This project is in early development and not ready for production use.

.lintstagedrc.json

@@ -0,0 +1,61 @@
+# mise.toml
+# Universal Toolchain Standard - Nov 2025
+# Context: Solo Developer / 50+ Repos
+
+min_version = "2024.11.1"
+
+[tools]
+# --- Core Runtimes ---
+# Pinned to latest stable versions as of Nov 2025
+node        = "22"       # LTS
+python      = "3.13"     # Stable (Performance Improvements)
+rust        = "stable"   # Latest Stable
+# go          = "1.23"   # Not currently used in ColdVox
+
+# --- Utility Toolchain ---
+# High-performance replacements for legacy tools
+uv          = "latest"   # Replaces pip/poetry (Rust-based)
+ripgrep     = "latest"   # Fast search
+jq          = "latest"   # JSON processor
+actionlint  = "latest"   # GitHub Actions linter
+typos       = "latest"   # Source code spell checker
+
+[env]
+# --- Environment Consistency ---
+# Prioritize local node_modules binaries.
+# This allows running 'eslint' directly without 'npx', saving network/startup time.
+_.path = ["{{config_root}}/node_modules/.bin"]
+PYTHONIOENCODING = "utf-8"
+
+[tasks.pre-commit]
+description = "Universal Git Pre-commit Hook"
+# CRITICAL: Invokes the local lint-staged binary directly via mise exec.
+# Avoids 'npx' to prevent registry lookup latency.
+run = "lint-staged"
+
+# --- TASK DELEGATION LAYER ---
+# lint-staged delegates logic here.
+
+[tasks."fmt:rust"]
+description = "Format & Lint Rust (Cargo)"
+run = """
+cargo fmt --
+# --allow-dirty is required because hooks run on dirty states by definition
+cargo clippy --fix --allow-dirty --allow-staged --all-targets --locked -- -D warnings
+"""
+
+[tasks."check:lockfiles"]
+description = "Prevent Lockfile Drift"
+# Runs a dry-run install to verify lockfiles match manifests.
+run = """
+#!/bin/bash
+if [ -f package-lock.json ]; then npm ci --dry-run; fi
+"""
+
+[tasks.actionlint]
+description = "Lint GitHub Actions"
+run = "actionlint"
+
+[tasks.typos]
+description = "Spell Check"
+run = "typos"