chore(tooling): strict-but-sane lint stack + intelligent pre-commit gate

.editorconfig

@@ -0,0 +1,38 @@
+# https://editorconfig.org
+# Universal style enforcement for EVERY file type in the repo.
+# editorconfig-checker verifies all of these rules and fails on any violation.
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+# Shell scripts (husky hooks) — POSIX sh, 2-space indent
+[.husky/*]
+indent_style = space
+indent_size = 2
+
+# GitHub Actions YAML uses 2-space indentation
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+# Binary media files must be left untouched
+[*.{png,gif,jpg,jpeg,ico}]
+insert_final_newline = false
+trim_trailing_whitespace = false
+
+# Markdown: no trailing whitespace, final newline required.
+# Indentation is NOT enforced here: markdown leading whitespace is content
+# (ASCII-art diagrams, nested-list alignment), not code style — markdownlint
+# governs markdown formatting instead.
+[*.md]
+indent_style = unset
+indent_size = unset
+trim_trailing_whitespace = true
+insert_final_newline = true

.github/dependabot.yml

@@ -1,9 +1,9 @@
 version: 2
 updates:
-  - package-ecosystem: "npm"
-    directory: "/"
+  - package-ecosystem: npm
+    directory: /
     schedule:
-      interval: "monthly"
+      interval: monthly
     open-pull-requests-limit: 3
     labels:
-      - "dependencies"
+      - dependencies

.github/workflows/ci.yml

@@ -32,6 +32,9 @@ jobs:
       - name: 🔎 Lint source and maintenance docs
         run: npm run lint
 
+      - name: 🎨 Check formatting
+        run: npm run format:check
+
       - name: 🧪 Run tests
         run: npm test
 

.gitignore

@@ -2,6 +2,6 @@ node_modules/
 out/
 *.vsix
 .DS_Store
-scripts/validate-models.mjs
-scripts/validate-models.mjs.map
+scripts/validate-models.js
+scripts/validate-models.js.map
 tmp/

.husky/pre-commit

@@ -1 +1,24 @@
-npx lint-staged
+#!/usr/bin/env sh
+# Fail fast: a failing step aborts the commit so the formatter can't mask a lint error.
+set -e
+
+# Some commit UIs run hooks with a stripped PATH that omits nvm's bin dir, so
+# npx/npm can be missing here. Resolve them so the gate never silently skips.
+if ! command -v npx >/dev/null 2>&1; then
+  node_bin="${NVM_BIN:-}"
+  if [ -z "$node_bin" ] || [ ! -x "$node_bin/npx" ]; then
+    node_bin="$(find "$HOME/.nvm/versions/node" -maxdepth 3 -type d -name bin 2>/dev/null | sort -V | tail -n 1)"
+  fi
+  if [ -n "$node_bin" ] && [ -x "$node_bin/npx" ]; then
+    export PATH="$node_bin:$PATH"
+  fi
+fi
+
+# Zero-tolerance gate on exactly what this change can affect: the staged
+# files plus the files that import them (see scripts/staged-lint.ts). Runs
+# BEFORE formatting so the linter sees the file as written. The full-tree
+# lint (including tests) runs in CI and on demand via `npm run lint`.
+npx tsx scripts/staged-lint.ts
+
+# Format changed files (code + non-code) after linting passes.
+npx lint-staged

.markdownlint-cli2.jsonc → .markdownlint-cli2.json

@@ -2,11 +2,11 @@
   "config": {
     "MD013": false,
     "MD024": {
-      "siblings_only": true,
+      "siblings_only": true
     },
     "MD033": false,
     "MD041": false,
-    "MD060": false,
+    "MD060": false
   },
-  "gitignore": true,
+  "gitignore": true
 }

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "files.associations": {
+    "**/.husky/*": "shellscript"
+  }
+}

.vscodeignore

@@ -1,12 +1,12 @@
 .gitignore
 .github/**
 .husky/**
-.markdownlint-cli2.jsonc
+.markdownlint-cli2.json
 .prettierrc.json
 .vscode/**
 .vscode-test/**
 docs/**/*.md
-eslint.config.mjs
+eslint.config.ts
 node_modules/**
 !node_modules/@silvia-odwyer/
 !node_modules/@silvia-odwyer/photon-node/

README.md

@@ -344,28 +344,28 @@ Provider diagnostics also include the VS Code/extension versions, extension host
 
 ## 🔧 Settings
 
-| Setting                                   | Default  | Description                                                                      |
-| ----------------------------------------- | -------- | -------------------------------------------------------------------------------- |
-| `opencodego.temperature`                  | `0.2`    | Sampling temperature (`0`–`2`)                                                   |
-| `opencodego.maxTokens`                    | `0`      | Max output token override (`0` = per-model max)                                  |
-| `opencodego.maxInputTokens`               | `0`      | Context window override (`0` = per-model default)                                |
-| `opencodego.debugReasoning`               | `false`  | Log `reasoning_content` to Output panel                                          |
-| `opencodego.requestTimeoutSeconds`        | `600`    | Total request timeout                                                            |
-| `opencodego.streamIdleTimeoutSeconds`     | `120`    | Cancel if stream goes idle                                                       |
-| `opencodego.showUsageStatusBar`           | `true`   | Show usage summary in status bar                                                 |
-| `opencodego.showProviderPrefix`           | `true`   | Include `OpenCode Go` / `OpenCode Zen` in model names                            |
+| Setting                                   | Default  | Description                                                                                                            |
+| ----------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `opencodego.temperature`                  | `0.2`    | Sampling temperature (`0`–`2`)                                                                                         |
+| `opencodego.maxTokens`                    | `0`      | Max output token override (`0` = per-model max)                                                                        |
+| `opencodego.maxInputTokens`               | `0`      | Context window override (`0` = per-model default)                                                                      |
+| `opencodego.debugReasoning`               | `false`  | Log `reasoning_content` to Output panel                                                                                |
+| `opencodego.requestTimeoutSeconds`        | `600`    | Total request timeout                                                                                                  |
+| `opencodego.streamIdleTimeoutSeconds`     | `120`    | Cancel if stream goes idle                                                                                             |
+| `opencodego.showUsageStatusBar`           | `true`   | Show usage summary in status bar                                                                                       |
+| `opencodego.showProviderPrefix`           | `true`   | Include `OpenCode Go` / `OpenCode Zen` in model names                                                                  |
 | `opencodego.visionProxyWholeConversation` | `false`  | Vision proxy: describe the whole conversation instead of only the message with a new image (more context, more tokens) |
-| `opencodego.freeOnly`                     | `true`   | Zen: free models only. `false` = include paid                                    |
-| `opencodego.agentsWindow`                 | `true`   | Expose agent-host model variants (`targetChatSessionType`) for the Agents window |
-| `opencodego.showAgentModelsInManagePanel` | `false`  | Show agent vendors in Manage Language Models panel                               |
-| `opencodego.stripThinkTags`               | `"auto"` | Strip `<think>` tags (`never`/`auto`/`always`)                                   |
-| `opencodego.thinking.deepseek`            | `"off"`  | `off`/`low`/`medium`/`high`/`max`                                                |
-| `opencodego.thinking.glm`                 | `"off"`  | `on`/`off`                                                                       |
-| `opencodego.thinking.kimi`                | `"off"`  | `on`/`off`                                                                       |
-| `opencodego.thinking.minimax`             | `"off"`  | `off`/`on`                                                                       |
-| `opencodego.thinking.mimo`                | `"off"`  | `off`/`low`/`medium`/`high`                                                      |
-| `opencodego.thinking.qwen`                | `"off"`  | `auto`/`on`/`off`                                                                |
-| `opencodego.thinking.qwenBudget`          | `"auto"` | `auto`/`4096`/`16384`/`32768`/`81920`                                            |
+| `opencodego.freeOnly`                     | `true`   | Zen: free models only. `false` = include paid                                                                          |
+| `opencodego.agentsWindow`                 | `true`   | Expose agent-host model variants (`targetChatSessionType`) for the Agents window                                       |
+| `opencodego.showAgentModelsInManagePanel` | `false`  | Show agent vendors in Manage Language Models panel                                                                     |
+| `opencodego.stripThinkTags`               | `"auto"` | Strip `<think>` tags (`never`/`auto`/`always`)                                                                         |
+| `opencodego.thinking.deepseek`            | `"off"`  | `off`/`low`/`medium`/`high`/`max`                                                                                      |
+| `opencodego.thinking.glm`                 | `"off"`  | `on`/`off`                                                                                                             |
+| `opencodego.thinking.kimi`                | `"off"`  | `on`/`off`                                                                                                             |
+| `opencodego.thinking.minimax`             | `"off"`  | `off`/`on`                                                                                                             |
+| `opencodego.thinking.mimo`                | `"off"`  | `off`/`low`/`medium`/`high`                                                                                            |
+| `opencodego.thinking.qwen`                | `"off"`  | `auto`/`on`/`off`                                                                                                      |
+| `opencodego.thinking.qwenBudget`          | `"auto"` | `auto`/`4096`/`16384`/`32768`/`81920`                                                                                  |
 
 <details>
 <summary><b>📜 Full settings reference with descriptions</b></summary>