package.json

{
  "name": "sidecar-ai",
  "displayName": "SideCar",
  "description": "Autonomous AI agent for coding — run full agent loops with local Ollama, Anthropic Claude, or OpenAI models",
  "version": "0.123.0",
  "license": "MIT",
  "publisher": "nedonatelli",
  "author": {
    "name": "Nicholas Donatelli",
    "email": "sidecarai.vscode@gmail.com"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/nedonatelli/sidecar"
  },
  "bugs": {
    "url": "https://github.com/nedonatelli/sidecar/issues",
    "email": "sidecarai.vscode@gmail.com"
  },
  "engines": {
    "vscode": "^1.116.0",
    "node": ">=20.0.0"
  },
  "icon": "media/SideCar.png",
  "categories": [
    "AI",
    "Chat"
  ],
  "keywords": [
    "ollama",
    "ai",
    "chat",
    "llama",
    "llm",
    "local",
    "mistral",
    "gemma",
    "codellama",
    "copilot",
    "cline"
  ],
  "activationEvents": [
    "onStartupFinished"
  ],
  "main": "./dist/extension.js",
  "contributes": {
    "configuration": [
      {
        "title": "SideCar: Backend & Models",
        "properties": {
          "sidecar.baseUrl": {
            "type": "string",
            "default": "http://localhost:11434",
            "order": 0,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Base URL for the active LLM backend.\n\n| Backend | URL |\n|---|---|\n| Ollama (local) | `http://localhost:11434` |\n| Anthropic | `https://api.anthropic.com` |\n| OpenAI | `https://api.openai.com` |\n| OpenAI-compatible | your endpoint, e.g. `https://host/v1` (trailing `/v1` optional) |\n| Kickstand | `http://localhost:11435` |\n\nSwitch backends the easy way: `SideCar: Switch Backend` in the Command Palette."
          },
          "sidecar.apiKey": {
            "type": "string",
            "default": "ollama",
            "order": 1,
            "tags": [
              "sidecar",
              "backend",
              "secret"
            ],
            "markdownDescription": "API key for the active backend. **Stored in VS Code SecretStorage** — never in `settings.json`. Run `SideCar: Set / Refresh API Key` to paste or rotate your key securely. Plaintext values in this setting are migrated to SecretStorage on activation and then cleared.\n\nIgnored for local Ollama; required for Anthropic and OpenAI."
          },
          "sidecar.model": {
            "type": "string",
            "default": "gemma4:e4b",
            "order": 2,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Model to use for chat. **Recommended local default: `gemma4:e4b`** (9 GB, ~10 GB VRAM; the most-dogfooded local model, strongest prompt-following).\n\nExamples:\n\n- Ollama: `gemma4:e4b`, `ministral-3:latest` (6 GB, lighter), `granite4.1:3b` (2 GB low-RAM), `qwen2.5-coder:7b`\n- Anthropic: `claude-opus-4-6`, `claude-sonnet-4-5`, `claude-haiku-4-5`\n- OpenAI: `gpt-5`, `gpt-4o`, `gpt-4o-mini`\n\nPick keyboard-first with `SideCar: Select Model`."
          },
          "sidecar.editorModel": {
            "type": "string",
            "default": "",
            "order": 3,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "**Architect / Editor split.** When set, agent-loop turns are routed to two models:\n\n- **Architect** (`#sidecar.model#`): planning turns — first turn and any turn following a pure-text response. Uses your main (expensive) model.\n- **Editor** (this setting): execution turns — any turn following tool calls. Use a cheaper/faster model here.\n\nExamples: set `#sidecar.model#` to `claude-opus-4-7` and this to `claude-haiku-4-5` to cut costs on long agent runs.\n\nLeave empty (default) to disable the split — all turns use `#sidecar.model#`."
          },
          "sidecar.webSearch.provider": {
            "type": "string",
            "enum": [
              "duckduckgo",
              "tavily",
              "brave"
            ],
            "enumDescriptions": [
              "DuckDuckGo HTML scraping — no API key required. May be less reliable.",
              "Tavily — purpose-built LLM search API. Requires sidecar.webSearch.apiKey (get a key at tavily.com).",
              "Brave Search API — privacy-focused, independent index. Requires sidecar.webSearch.apiKey (get a key at brave.com/search/api)."
            ],
            "default": "duckduckgo",
            "order": 4,
            "tags": [
              "sidecar",
              "backend"
            ],
            "description": "Web search provider used by the web_search tool. DuckDuckGo requires no key; Tavily and Brave require sidecar.webSearch.apiKey."
          },
          "sidecar.webSearch.apiKey": {
            "type": "string",
            "default": "",
            "order": 5,
            "tags": [
              "sidecar",
              "backend"
            ],
            "description": "API key for the selected web search provider. Required when sidecar.webSearch.provider is 'tavily' or 'brave'. Stored in settings.json — use a key with minimal permissions."
          },
          "sidecar.provider": {
            "type": "string",
            "enum": [
              "auto",
              "ollama",
              "anthropic",
              "openai",
              "openai-compat",
              "openrouter",
              "groq",
              "fireworks",
              "gemini",
              "kickstand",
              "copilot",
              "bedrock"
            ],
            "enumDescriptions": [
              "Detect from the base URL: localhost:11434 → Ollama, anthropic.com → Anthropic, openrouter.ai → OpenRouter, groq.com → Groq, fireworks.ai → Fireworks, generativelanguage.googleapis.com → Gemini, localhost:11435 → Kickstand, anything else → OpenAI-compatible.",
              "Local Ollama (http://localhost:11434). Free, private, no key needed.",
              "Anthropic Claude API. Requires an API key stored via `SideCar: Set / Refresh API Key`.",
              "OpenAI-compatible API (OpenAI, LM Studio, vLLM, llama.cpp, together.ai). Requires an API key.",
              "Any OpenAI-compatible endpoint — self-hosted (vLLM, mlx-lm, llama.cpp) or a gateway. Set sidecar.baseUrl to the endpoint and sidecar.apiKey to its token. A trailing /v1 is optional.",
              "OpenRouter (https://openrouter.ai/api/v1). One API key unlocks hundreds of models across providers (Anthropic, OpenAI, Google, Mistral, Meta, and more) with per-model pricing pulled live from their catalog. Requires an OpenRouter API key.",
              "Groq (https://api.groq.com/openai/v1). LPU inference serves open-weight models (Llama 3.3, Mixtral, DeepSeek R1 distills) at thousands of tokens/sec. Free tier with rate limits. Requires a Groq API key from console.groq.com.",
              "Fireworks (https://api.fireworks.ai/inference/v1). Hosts open-weight models like DeepSeek V3, Qwen 2.5 Coder, Llama 3.3, Mixtral at OpenAI-compatible pricing. Requires an API key from fireworks.ai.",
              "Google Gemini (https://generativelanguage.googleapis.com/openai). Gemini 2.0 Flash, Pro, and Ultra via the OpenAI-compatible endpoint. Requires an API key from aistudio.google.com/apikey.",
              "Kickstand self-hosted LLM server (http://localhost:11435). Reads its bearer token automatically from `~/.config/kickstand/token`. No API key prompt shown.",
              "GitHub Copilot via `vscode.lm`. Uses your existing GitHub Copilot subscription — no separate API key required. Requires the GitHub Copilot extension to be installed and signed in.",
              "AWS Bedrock for Claude models (bedrock-runtime.<region>.amazonaws.com). No API key — uses the AWS credential chain (env vars or ~/.aws/credentials). Set `sidecar.bedrock.region` and use a Bedrock model / inference-profile ID."
            ],
            "default": "auto",
            "order": 3,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Which backend adapter to use when talking to the LLM. Leave as `auto` unless you're running an OpenAI-compatible server at a non-standard URL that the auto-detector can't recognize."
          },
          "sidecar.bedrock.region": {
            "type": "string",
            "default": "us-east-1",
            "order": 4,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "AWS region for the Bedrock backend (e.g. `us-east-1`, `us-west-2`, `eu-central-1`). The Bedrock Runtime endpoint is derived as `bedrock-runtime.<region>.amazonaws.com`. Credentials come from the standard AWS chain (env vars or `~/.aws/credentials`); no API key prompt is shown."
          },
          "sidecar.bedrock.fips": {
            "type": "boolean",
            "default": false,
            "order": 5,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Use the Bedrock **FIPS** endpoint — `bedrock-runtime-fips.<region>.amazonaws.com` instead of the standard host. Required for some connections, notably **AWS GovCloud** (`us-gov-east-1` / `us-gov-west-1`). The `SideCar: Bedrock: Set Region` command offers this automatically for GovCloud regions and keeps `sidecar.baseUrl` in sync."
          },
          "sidecar.fallbackBaseUrl": {
            "type": "string",
            "default": "",
            "order": 45,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Fallback backend URL. If the primary backend fails repeatedly, SideCar switches to this URL automatically. Leave empty to disable fallback.\n\nTypical use: primary = Anthropic, fallback = local Ollama, so a transient API outage doesn't block your work."
          },
          "sidecar.fallbackApiKey": {
            "type": "string",
            "default": "",
            "order": 46,
            "tags": [
              "sidecar",
              "backend",
              "secret"
            ],
            "markdownDescription": "API key for the fallback backend. **Stored in VS Code SecretStorage** — plaintext values are migrated on activation and then cleared from `settings.json`."
          },
          "sidecar.fallbackModel": {
            "type": "string",
            "default": "",
            "order": 47,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Model to use on the fallback backend. Empty string = reuse the primary model (only useful when the primary and fallback are the same provider family)."
          },
          "sidecar.requestTimeout": {
            "type": "number",
            "default": 120,
            "description": "Timeout in seconds between tokens during streaming. If no new tokens arrive within this window the request is aborted. Set to 0 to disable."
          },
          "sidecar.firstTokenTimeout": {
            "type": "number",
            "default": 300,
            "description": "Minimum seconds to wait for the first token from the model, before prompt-size headroom is added. Large contexts (big repos) automatically get proportionally more time so prefill isn't aborted mid-stream; this value is the floor for small prompts. Local models (Ollama) can take longer to start when loading from disk or warming up. Set to 0 to disable."
          },
          "sidecar.dailyBudget": {
            "type": "number",
            "default": 0,
            "minimum": 0,
            "order": 48,
            "tags": [
              "sidecar",
              "cost"
            ],
            "markdownDescription": "Daily spending budget in USD for paid backends. Agent runs are blocked when the limit is reached. `0` = disabled. Check current spend with `SideCar: Show Session Spend`."
          },
          "sidecar.weeklyBudget": {
            "type": "number",
            "default": 0,
            "minimum": 0,
            "order": 49,
            "tags": [
              "sidecar",
              "cost"
            ],
            "markdownDescription": "Weekly spending budget in USD for paid backends. Agent runs are blocked when the limit is reached. `0` = disabled."
          },
          "sidecar.modelRouting.enabled": {
            "type": "boolean",
            "default": false,
            "order": 50,
            "tags": [
              "sidecar",
              "routing"
            ],
            "markdownDescription": "Route each agent dispatch role (`chat`, `agent-loop`, `completion`, `summarize`, `critic`, `worker`, `planner`, `judge`, `visual`, `embed`) to a rule-selected model. Opt-in — when `false`, every role uses `#sidecar.model#` (legacy behavior). Configure rules via `#sidecar.modelRouting.rules#`."
          },
          "sidecar.modelRouting.rules": {
            "type": "array",
            "default": [],
            "order": 51,
            "tags": [
              "sidecar",
              "routing"
            ],
            "items": {
              "type": "object",
              "properties": {
                "when": {
                  "type": "string",
                  "description": "Role match. Forms: `agent-loop`, `agent-loop.complexity=high`, `agent-loop.retryCount>=3`, `chat.prompt~=/prove\\b|think hard/i`, `agent-loop.files~=src/physics/**`."
                },
                "model": {
                  "type": "string",
                  "description": "Model id to dispatch with when this rule matches."
                },
                "fallbackModel": {
                  "type": "string",
                  "description": "Downgrade target when a budget cap on this rule is exceeded (v0.64 phase 4c)."
                },
                "sessionBudget": {
                  "type": "number",
                  "description": "Session spend cap in USD. Budget tripped → downgrade to `fallbackModel`."
                },
                "dailyBudget": {
                  "type": "number"
                },
                "hourlyBudget": {
                  "type": "number"
                }
              },
              "required": [
                "when",
                "model"
              ]
            },
            "markdownDescription": "Ordered list of routing rules, first match wins. See `#sidecar.modelRouting.enabled#` for the opt-in switch. Example: `[{ \"when\": \"agent-loop.complexity=high\", \"model\": \"claude-opus-4-6\" }, { \"when\": \"summarize\", \"model\": \"claude-haiku-4-5\" }, { \"when\": \"chat\", \"model\": \"ollama/llama3:70b\" }]`"
          },
          "sidecar.modelRouting.defaultModel": {
            "type": "string",
            "default": "",
            "order": 52,
            "tags": [
              "sidecar",
              "routing"
            ],
            "markdownDescription": "Model used when no rule in `#sidecar.modelRouting.rules#` matches. Empty → falls back to `#sidecar.model#`."
          },
          "sidecar.modelRouting.visibleSwaps": {
            "type": "boolean",
            "default": true,
            "order": 53,
            "tags": [
              "sidecar",
              "routing"
            ],
            "markdownDescription": "Show a brief toast whenever a routing rule swaps the active model mid-session. Turn off once you've calibrated your rules and don't want to see the notifications."
          },
          "sidecar.modelRouting.dryRun": {
            "type": "boolean",
            "default": false,
            "order": 54,
            "tags": [
              "sidecar",
              "routing"
            ],
            "markdownDescription": "Log what the router *would* have selected but dispatch using `#sidecar.model#` anyway. Useful for safely calibrating rules before turning `#sidecar.modelRouting.enabled#` on."
          }
        }
      },
      {
        "title": "SideCar: Agent",
        "properties": {
          "sidecar.agentMode": {
            "type": "string",
            "default": "cautious",
            "order": 20,
            "tags": [
              "sidecar",
              "agent"
            ],
            "markdownDescription": "How much autonomy the agent has. Built-in modes:\n\n- `cautious` — asks before destructive tools (default)\n- `autonomous` — runs every allowed tool without asking\n- `manual` — asks before every tool\n- `plan` — generates a plan for your approval, then executes\n- `review` — queues file edits for review; nothing hits disk\n- `audit` *(v0.60)* — agent runs without per-call prompts, but every `write_file` / `edit_file` / `delete_file` is diverted to an in-memory buffer instead of touching disk. The user reviews the buffered changes at the end and either accepts (atomic flush) or rejects (discard). Shell commands still run normally — scope is the agent's explicit file-authoring surface, not every side effect.\n\nCustom modes defined in `#sidecar.customModes#` are also valid here."
          },
          "sidecar.agentTemperature": {
            "type": "number",
            "default": 0.2,
            "minimum": 0,
            "maximum": 2,
            "order": 21,
            "tags": [
              "sidecar",
              "agent"
            ],
            "markdownDescription": "Temperature for LLM requests.\n\n- `0.1-0.3` — deterministic tool selection (recommended for agent loops)\n- `0.7-1.0` — creative, more exploration\n\nApplied to every request on Ollama and Kickstand; on Anthropic/Bedrock applied where the model supports it; on OpenAI-compatible backends applied only to tool-bearing requests (plain requests use the provider default)."
          },
          "sidecar.agentSeed": {
            "type": [
              "number",
              "null"
            ],
            "default": null,
            "order": 21,
            "tags": [
              "sidecar",
              "agent"
            ],
            "markdownDescription": "Fixed RNG seed for generation, for **reproducible runs** (benchmarks / ablation). `null` (default) leaves generation unseeded. When set, identical prompts produce identical outputs on backends that honor a seed (Ollama). The `SIDECAR_AGENT_SEED` environment variable overrides this for headless runs."
          },
          "sidecar.ollama.numCtx": {
            "type": [
              "number",
              "null"
            ],
            "default": null,
            "minimum": 512,
            "order": 22,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Override the context window size (`num_ctx`) sent to Ollama with every request. When set, this takes precedence over the value probed from the model's Modelfile.\n\nLeave `null` to use the model's default (recommended). Set to `8192`, `32768`, `65536`, etc. to force a specific window. Only applies to the Ollama backend."
          },
          "sidecar.ollama.disableThinking": {
            "type": "boolean",
            "default": false,
            "order": 23,
            "tags": [
              "sidecar",
              "backend"
            ],
            "markdownDescription": "Disable the extended reasoning (`think`) phase for Ollama models that support it (e.g. Qwen3, DeepSeek-R1). When `true`, SideCar passes `think: false` with every request, skipping the internal chain-of-thought and reducing latency significantly at the cost of reasoning depth.\n\nLeave `false` (default) to keep thinking enabled — recommended for complex coding tasks. Enable when speed matters more than depth, or when running evals."
          },
          "sidecar.agentMaxIterations": {
            "type": "number",
            "default": 50,
            "minimum": 1,
            "maximum": 100,
            "order": 23,
            "tags": [
              "sidecar",
              "agent"
            ],
            "markdownDescription": "Maximum number of agent loop iterations before the agent stops. Each iteration is one model call plus any tools it chose. Hitting this limit usually means the agent is stuck in a cycle — inspect the chat and narrow the task."
          },
          "sidecar.agentMaxMessages": {
            "type": "number",
            "default": 25,
            "minimum": 5,
            "maximum": 200,
            "order": 23,
            "tags": [
              "sidecar",
              "agent"
            ],
            "markdownDescription": "Soft ceiling on conversation message count before the agent should wrap up. The agent still completes the current tool cycle if it's in the middle of one."
          },
          "sidecar.agentMaxTokens": {
            "type": "number",
            "default": 200000,
            "minimum": 1000,
            "maximum": 1000000,
            "order": 24,
            "tags": [
              "sidecar",
              "agent"
            ],
            "markdownDescription": "Maximum total tokens (message history only, system prompt excluded) the agent loop may consume before it stops. Acts as a cost-control ceiling: the loop automatically uses the model's reported context window if smaller. Lower this if you want to limit per-run cost on paid backends."
          },
          "sidecar.toolPermissions": {
            "type": "object",
            "default": {},
            "description": "Per-tool permission overrides: { \"tool_name\": \"allow\" | \"deny\" | \"ask\" }"
          },
          "sidecar.systemPrompt": {
            "type": "string",
            "default": "",
            "order": 10,
            "tags": [
              "sidecar",
              "context"
            ],
            "markdownDescription": "System prompt override. Leave empty to use SideCar's built-in prompt (recommended). Custom prompts compose on top of the base; they don't replace it."
          },
          "sidecar.bgMaxConcurrent": {
            "type": "number",
            "default": 3,
            "minimum": 1,
            "maximum": 10,
            "description": "Maximum number of background agents that can run simultaneously"
          },
          "sidecar.shellTimeout": {
            "type": "number",
            "default": 120,
            "description": "Seconds a shell command may run WITHOUT producing output before it is treated as hung and killed. Any output resets the clock, so long-running commands that keep printing (test suites, builds) are not interrupted.",
            "minimum": 1
          },
          "sidecar.shellMaxOutputMB": {
            "type": "number",
            "default": 0,
            "description": "Hard ceiling on captured shell output, in MB. 0 (default) auto-bounds capture near the model's context budget — the prompt pruner keeps only ~16KB of any tool result, so capturing megabytes just wastes memory. Set a positive value to force a fixed MB ceiling (e.g. to see more of a long stream in the webview)."
          }
        }
      },
      {
        "title": "SideCar: Safety & Review",
        "properties": {
          "sidecar.adaptiveScaffolding.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Tune loop-safety scaffolding to the active model's capability tier. Weak models get a larger reprompt and gate budget to recover; strong models get a looser burst cap and hold more context before compacting. Verification budgets are never reduced. Measured neutral-to-positive across llama3.2 / ministral-3 / granite4.1 / qwen2.5-coder / qwen3.5 / gemma4 and claude-sonnet-5."
          },
          "sidecar.modelLearning.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Learn each model's capability tier from how it actually performs in this workspace, instead of guessing it from the model's name. Demotes a model (more scaffolding) when it fails; promotes it (less scaffolding) only when it succeeds WITHOUT ever needing the scaffolding to intervene. Requires sidecar.adaptiveScaffolding.enabled. Turn off to pin tiers to their defaults."
          },
          "sidecar.modelTier": {
            "type": "object",
            "default": {},
            "additionalProperties": {
              "type": "string",
              "enum": [
                "weak",
                "medium",
                "strong"
              ]
            },
            "markdownDescription": "Explicit capability tier per model — overrides detection entirely, including anything SideCar has learned. Use when the automatic tier is wrong for your hardware or codebase.\n\nExample: `{ \"llama3.2\": \"weak\", \"qwen2.5-coder:7b\": \"medium\" }`\n\n`weak` = maximum scaffolding (more reprompts, more gate retries, no LLM critic). `strong` = minimum (fewer reprompts, larger burst cap, lower latency)."
          },
          "sidecar.scaffolding.overrides": {
            "type": "object",
            "default": {},
            "markdownDescription": "Pin individual scaffolding triggers regardless of the model's tier. Applied last, over everything else.\n\nExample: `{ \"runLlmCritic\": true, \"burstCap\": 20 }`\n\nKeys: `burstCap`, `maxActionReprompts`, `maxGateInjections`, `runLlmCritic`, `planModeAskUser`, `compressionThreshold`, `compactionKeepRecentTurns`, `compactionMaxSummaryChars`."
          },
          "sidecar.plan.externalized": {
            "type": "boolean",
            "default": false,
            "description": "Externalized planning (S1). Adds an update_plan tool the model calls to keep a step-by-step plan OUTSIDE the message window; the harness re-injects {current step, last result, remaining steps} every turn, so the plan survives context compression on long tasks. Experimental — pending ablation evidence (Prove-or-Prune Ledger)."
          },
          "sidecar.scaffolding.keepBest": {
            "type": "boolean",
            "default": true,
            "description": "Pareto-safe scaffolding (keep-best ratchet). The loop snapshots your files at the point scaffolding first drives extra work, then at the end reverts scaffold-driven changes that regressed a passing test OR grew the patch with no test-signal gain (over-engineering). By default ANY unproven growth reverts, not just large bloat — see keepBestOverEngineerBytes. Makes the completion gate / critic unable to turn a good run into a worse one. Every revert is surfaced with the file list. Disabled automatically in audit mode (writes are buffered, not on disk). Default-on since v0.118 (measured: over-engineering roughly halved on a 150-run SWE campaign with no possible resolve harm)."
          },
          "sidecar.scaffolding.keepBestOverEngineerBytes": {
            "type": "number",
            "default": 0,
            "description": "Byte growth past which a scaffold-driven patch that improved no test signal is reverted as over-engineered (keep-best ratchet). Default 0: any growth without a proven improvement (a new passing test, or the project suite going green) reverts — a byte-size gate alone can't tell a legitimate small addition from a wrong one. Raise this (e.g. 4096) to tolerate some unverified growth before reverting."
          },
          "sidecar.scaffolding.cycleDetectionMinRepeats": {
            "type": "number",
            "default": 10,
            "minimum": 1,
            "description": "Repeats of the same tool + file (content-aware) before the agent loop bails as a stuck cycle. Default 10 — was a fixed 3. Weaker/smaller models sometimes need a few attempts to self-correct from a hint (e.g. an edit_file search/replace mistake) before genuinely succeeding; raising this gives more retries before the safety net stops the loop, at the cost of a truly stuck model burning more iterations first. Lower it (e.g. back to 3) for a stricter, faster-to-bail loop."
          },
          "sidecar.recovery.codeAsText": {
            "type": "boolean",
            "default": true,
            "description": "Code-as-text recovery for models that print code instead of calling tools: parses call-expression syntax emitted as prose (write_file(path=…, content=…)), detects fabricated <tool_output> blocks, decodes literal-escape contamination (\\n as two characters), splits fused anchor+content inserts, and synthesizes a bounded write from a complete code fence on a mutation request. Every layer is a rescue path dormant unless its failure shape occurs, so it is a no-op on capable models. Default-on since v0.120 (proven: 0/28 → 11/27 on qwen2.5-coder, p=0.001; zero net-negative discordants across five model families)."
          },
          "sidecar.editFile.steerToWrite": {
            "type": "boolean",
            "default": false,
            "description": "When edit_file keeps failing on the same file (a weak model echoing existing content into the insert fields, never producing the delta), steer the model to rewrite the whole file with write_file — the shape it can do. Off by default: a 30-pair campaign measured a real powered null (symmetric discordants with the steer firing 37×), so it ships for manual use only."
          },
          "sidecar.editFile.steerToWriteThreshold": {
            "type": "number",
            "default": 3,
            "minimum": 2,
            "description": "Consecutive edit_file failures on one file before the steer-to-write reprompt fires (when sidecar.editFile.steerToWrite is on)."
          },
          "sidecar.autoFixOnFailure": {
            "type": "boolean",
            "default": false,
            "description": "Automatically check for errors after agent edits and feed them back to the model for self-correction"
          },
          "sidecar.autoFixMaxRetries": {
            "type": "number",
            "default": 3,
            "description": "Maximum auto-fix attempts before stopping"
          },
          "sidecar.completionGate.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Require the agent to run lint and tests for files it edited before declaring completion. Catches cases where the agent reports a change as done without verifying."
          },
          "sidecar.behavioralVerificationGate.enabled": {
            "type": "boolean",
            "default": false,
            "description": "When the agent edits behavioral code without running a test that actually exercises it, reprompt it to write one. Off by default: on local models this tends to push a correct fix into writing extra, often broken, test files (the same over-edit pattern as the removed critic). Enable to study its effect."
          },
          "sidecar.syntaxGate.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Refuse to let the agent finish (and break a cycle-detection bail) while a file it edited fails to parse — runs the language's cheap parse check on edited files. On by default; requires the completion gate. Disable to run the agent loop without deterministic syntax verification."
          },
          "sidecar.redCheckGate.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Refuse to let the agent declare the task done while its own last verification (a test/lint/compile it ran) is still failing. On by default; requires the completion gate. This is the verification-forcing lever most likely to rescue a wrong fix — and most likely to cause over-editing — so it is independently toggleable for study."
          },
          "sidecar.steerQueue.coalesceWindowMs": {
            "type": "number",
            "default": 2000,
            "minimum": 0,
            "maximum": 10000,
            "description": "When a user steer is queued, wait up to this many ms at the next iteration boundary to collect further submissions into a single coalesced turn. 0 disables coalescing (drain immediately)."
          },
          "sidecar.steerQueue.maxPending": {
            "type": "number",
            "default": 5,
            "minimum": 1,
            "maximum": 20,
            "description": "Maximum number of queued steers. When full, the oldest nudge is dropped to make room; an all-interrupt queue rejects new submissions."
          },
          "sidecar.multiFileEdits.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable multi-file edit streams: the agent plans an edit DAG before executing batches of file writes, then dispatches independent writes in parallel."
          },
          "sidecar.multiFileEdits.maxParallel": {
            "type": "number",
            "default": 8,
            "minimum": 1,
            "maximum": 32,
            "description": "Maximum number of file writes dispatched concurrently during a multi-file edit."
          },
          "sidecar.multiFileEdits.planningPass": {
            "type": "boolean",
            "default": true,
            "description": "Run a dedicated Edit Plan LLM turn before executing multi-file writes. Adds one extra turn of latency; disable to let the agent emit writes directly (the DAG scheduler still applies)."
          },
          "sidecar.multiFileEdits.minFilesForPlan": {
            "type": "number",
            "default": 3,
            "minimum": 2,
            "maximum": 50,
            "description": "Minimum number of file writes in one turn that triggers the Edit Plan pass. Smaller edits go directly to execution."
          },
          "sidecar.multiFileEdits.plannerModel": {
            "type": "string",
            "default": "",
            "description": "Override model used for the Edit Plan turn. Empty = reuse the main model. Point to a smaller local model (e.g. qwen2.5-coder:7b) to keep planning cheap."
          },
          "sidecar.multiFileEdits.reviewGranularity": {
            "type": "string",
            "enum": [
              "bulk",
              "per-file",
              "per-hunk"
            ],
            "default": "per-file",
            "description": "How the AUDIT-MODE review (SideCar: Review Audited Changes) presents buffered edits. 'bulk' = accept/reject all as one unit, 'per-file' = walk each file individually with Accept / Reject / diff (default), 'per-hunk' = walk each file's individual diff hunks so you can accept some and discard others. Has no effect on the Pending Agent Changes view used outside audit mode."
          },
          "sidecar.retrieval.graphExpansion.enabled": {
            "type": "boolean",
            "default": true,
            "description": "After semantic retrieval returns vector hits, walk the symbol graph's 'calls' edges outward by 1-2 hops (depth auto-scales with the model's context window) to surface dependency-coupled symbols that wouldn't score on keywords alone. Matters for dense, deeply-interconnected codebases (physics simulations, signal processing, transform libraries)."
          },
          "sidecar.retrieval.graphExpansion.maxHits": {
            "type": "number",
            "default": 8,
            "minimum": 0,
            "maximum": 50,
            "description": "Cap on symbols added via graph walk per retrieval call. Higher = deeper dependency coverage at more token cost; lower = tighter context for small-context local models."
          },
          "sidecar.retrieval.queryRewrite": {
            "type": "string",
            "default": "rule",
            "enum": [
              "off",
              "rule",
              "llm",
              "expand"
            ],
            "enumDescriptions": [
              "No rewriting — the raw user message is embedded as-is.",
              "Free, synchronous: strips conversational preambles (\"how do I\", \"can you help me with\", etc.) and expands camelCase identifiers so the embedding model can match partial terms.",
              "One LLM call (≤60 tokens, 3-second timeout) reformulates the rule-cleaned query into a tight technical search string; falls back to rule output on timeout or error.",
              "Same LLM call but requests 2 alternative phrasings in addition to the rule-cleaned query. All variants run in parallel through Reciprocal Rank Fusion so each angle of the query can surface different hits."
            ],
            "description": "Controls how the user's message is rewritten before embedding for retrieval. 'rule' is the recommended default — zero cost, consistent improvement. Switch to 'llm' or 'expand' for better recall at the cost of one small LLM call per turn."
          },
          "sidecar.facets.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable Typed Sub-Agent Facets — specialized sub-agents declared in .sidecar/facets/*.md with typed tool allowlists and RPC schemas. Built-in facets (general-coder, latex-writer, signal-processing, frontend, test-author, technical-writer, security-reviewer, data-engineer) are always available."
          },
          "sidecar.facets.maxConcurrent": {
            "type": "number",
            "default": 3,
            "minimum": 1,
            "maximum": 16,
            "description": "Maximum number of facets running in parallel. Guards GPU and context pressure when several specialists share the same local model. Within a single dispatch, independent facets run concurrently up to this cap; dependent facets wait for their prerequisites regardless."
          },
          "sidecar.facets.rpcTimeoutMs": {
            "type": "number",
            "default": 30000,
            "minimum": 1000,
            "maximum": 300000,
            "description": "Timeout for a single typed RPC call between facets. Exceeded calls return a synthetic timeout error to the caller rather than hanging the dispatch."
          },
          "sidecar.facets.registry": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Absolute paths to additional facet .md files (merged with built-ins). Omit to use only the built-in catalog plus any facets at .sidecar/facets/*.md in the active workspace."
          },
          "sidecar.designMd.enabled": {
            "type": "boolean",
            "default": true,
            "description": "When true, SideCar reads DESIGN.md from the workspace root and injects design tokens into the agent's context. The compact tokens block (colors, typography, spacing) is always included; the full prose rationale is added only when the active file is a UI file (*.css, *.tsx, *.svelte, etc.). Disable to suppress injection in projects that don't use DESIGN.md."
          },
          "sidecar.sidecarMd.mode": {
            "type": "string",
            "enum": [
              "full",
              "sections",
              "retrieval"
            ],
            "default": "sections",
            "markdownDescription": "How SIDECAR.md content is injected into the system prompt.\n\n| Mode | Behavior |\n|---|---|\n| `sections` (default) | Parse H2 boundaries, route sections based on `<!-- @paths: glob -->` sentinels, active editor, and user-mentioned paths. |\n| `retrieval` | Semantic retrieval mode — only `always`-priority sections are injected verbatim; all other sections are scored against the current query via cosine similarity and the top-K most relevant ones surface via the RRF fusion pipeline. Best for large SIDECAR.md files (20+ sections). |\n| `full` | Legacy behavior — dump the entire file and mid-chop on overflow. |\n\nPath-scoped sections declare their globs via an HTML-comment sentinel immediately under the H2 heading:\n\n```markdown\n## Transforms\n<!-- @paths: src/transforms/**, src/dsp/** -->\nFilter kernels go under src/transforms/...\n```",
            "requiresWindowReload": true
          },
          "sidecar.sidecarMd.retrieval.topK": {
            "type": "number",
            "default": 5,
            "minimum": 1,
            "maximum": 20,
            "description": "Maximum number of SIDECAR.md sections to surface per turn in retrieval mode. Only the top-K sections by cosine similarity (above minScore) are injected. Has no effect in `sections` or `full` mode."
          },
          "sidecar.sidecarMd.retrieval.minScore": {
            "type": "number",
            "default": 0.3,
            "minimum": 0,
            "maximum": 1,
            "description": "Minimum cosine similarity for a SIDECAR.md section to be included in retrieval mode. Sections below this threshold are never injected even if they rank in the top-K. Raise this to 0.4–0.5 to get tighter relevance; lower it toward 0 to always include the full top-K."
          },
          "sidecar.sidecarMd.alwaysIncludeHeadings": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "Build",
              "Conventions",
              "Setup"
            ],
            "description": "H2 headings that always get included in the system prompt regardless of @paths sentinels. Matched case-insensitively against section.heading. Useful for teams that don't want to edit their SIDECAR.md — 'always include the Build section' lives in user settings, not in the doc."
          },
          "sidecar.sidecarMd.lowPriorityHeadings": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "Glossary",
              "FAQ",
              "Changelog"
            ],
            "description": "H2 headings that are demoted to low priority — included only when budget remains after always + scoped sections. Matched case-insensitively."
          },
          "sidecar.sidecarMd.maxScopedSections": {
            "type": "number",
            "default": 5,
            "minimum": 1,
            "maximum": 50,
            "description": "Cap on how many path-scoped sections can land in one injection. Guards against a wildcard-ish path glob that matches 30 sections."
          },
          "sidecar.fork.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable Fork & Parallel Solve — the /fork command spawns N parallel approaches to the same task, each in its own Shadow Workspace, and presents them side-by-side for comparison."
          },
          "sidecar.fork.defaultCount": {
            "type": "number",
            "default": 3,
            "minimum": 2,
            "maximum": 10,
            "description": "Default number of forks spawned by /fork when no explicit count is passed. Clamped 2–10; values outside that range degenerate to 'agent loop with no comparison.'"
          },
          "sidecar.fork.maxConcurrent": {
            "type": "number",
            "default": 3,
            "minimum": 1,
            "maximum": 10,
            "description": "Max forks running in parallel at once. Clamped to [1, numForks] per dispatch. Higher values finish faster at the cost of more concurrent Shadow Workspaces (disk churn) and more concurrent LLM requests (cost + rate limits)."
          },
          "sidecar.arena.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable Model Arena — side-by-side comparison of 2–4 models on the same prompt, with ELO ratings stored in .sidecar/arena/elo.json.",
            "requiresWindowReload": true
          },
          "sidecar.arena.defaultModels": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Pre-populated model list for the Arena panel. When non-empty, the QuickPick is skipped and these models are used. Example: [\"llama3.2:3b\", \"qwen3:8b\"]."
          },
          "sidecar.kickstand.nCtx": {
            "type": "number",
            "default": 32768,
            "minimum": 512,
            "description": "Context window size (n_ctx) passed to Kickstand when loading a model. Increase this if you hit 'Prompt too long for model context window' errors. Must not exceed what your GPU VRAM can hold for the chosen model."
          },
          "sidecar.kickstand.ropeFreqBase": {
            "type": "number",
            "default": 0,
            "minimum": 0,
            "description": "RoPE base frequency override for Kickstand models. 0 = use the model's built-in value. Set to 500000 for Llama 3.1/3.3 to enable 128K context, or 1000000 for Qwen3 extended context."
          },
          "sidecar.kickstand.ropeFreqScale": {
            "type": "number",
            "default": 0,
            "minimum": 0,
            "description": "RoPE frequency scale factor for Kickstand models. 0 = use the model's built-in value. Values < 1 extend the context window (e.g. 0.5 doubles effective context length)."
          },
          "sidecar.kickstand.yarnExtFactor": {
            "type": "number",
            "default": -1,
            "description": "YaRN extrapolation mix factor. -1 = use the model's built-in default (recommended). 0 = disable YaRN. 1 = full YaRN extrapolation. Most modern long-context models (Llama 3.1, Qwen3) embed YaRN in their weights — leave this at -1 unless you know what you're doing."
          },
          "sidecar.kickstand.yarnOrigCtx": {
            "type": "number",
            "default": 0,
            "minimum": 0,
            "description": "YaRN original training context length. 0 = auto-detect from model metadata. Only needed if the automatic detection is wrong for your model."
          },
          "sidecar.kickstand.flashAttn": {
            "type": "boolean",
            "default": false,
            "description": "Enable Flash Attention when loading models in Kickstand. Gives 2–4× speedup on long contexts with Metal (macOS) or CUDA backends. Has no effect on CPU-only inference. Requires a rebuild of libkickstand_llm if not already compiled with Flash Attention support."
          },
          "sidecar.regressionGuards": {
            "type": "array",
            "default": [],
            "order": 21,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Declarative shell commands that act as hard gates the agent must pass before completing a task. Use for domain-specific correctness checks the general lint/test suite can't express — conservation-of-energy invariants in a physics sim, bundle-size budgets, API-contract diffs, etc.\n\nEach entry has: `name` (required, human-readable), `command` (required, shell), `trigger` (required, one of `post-write` / `post-turn` / `pre-completion`), and optional `blocking` (default `true`), `timeoutMs` (default 30000), `scope` (glob array; guard only fires when touched files match), `maxAttempts` (default 5 consecutive failures before giving up), `workingDir`.\n\nWhen blocking and exit ≠ 0, the guard output is injected as a synthetic user turn so the agent can read the error and revise. When non-blocking, the loop just surfaces a warning. The first time a workspace defines guards, SideCar prompts to trust them — same contract as `hooks`, `mcpServers`, `customTools`, `scheduledTasks`.",
            "items": {
              "type": "object",
              "required": [
                "name",
                "command",
                "trigger"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Short identifier for the guard (shown in failure messages)."
                },
                "command": {
                  "type": "string",
                  "description": "Shell command to run. Runs in the workspace root unless workingDir is set."
                },
                "trigger": {
                  "type": "string",
                  "enum": [
                    "post-write",
                    "post-turn",
                    "pre-completion"
                  ],
                  "description": "When the guard fires. post-write = after every turn that includes a file-mutation tool call; post-turn = after every turn; pre-completion = when the model tries to finish the task."
                },
                "blocking": {
                  "type": "boolean",
                  "default": true,
                  "description": "When true, failure injects a synthetic user turn so the agent must address it. When false, failure surfaces as a warning and the loop continues."
                },
                "timeoutMs": {
                  "type": "number",
                  "default": 30000,
                  "description": "Hard timeout for the command in ms."
                },
                "scope": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Optional glob list. Guard only fires when at least one touched file in this turn matches. Empty/missing = fire on every qualifying turn."
                },
                "maxAttempts": {
                  "type": "number",
                  "default": 5,
                  "description": "Give up after this many consecutive failures per task. Counter resets on any success."
                },
                "workingDir": {
                  "type": "string",
                  "description": "Optional working directory. Defaults to the workspace folder."
                }
              }
            }
          },
          "sidecar.regressionGuards.mode": {
            "type": "string",
            "enum": [
              "off",
              "strict",
              "warn"
            ],
            "default": "strict",
            "order": 22,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Global override for `sidecar.regressionGuards`.\n\n- `strict` (default) — honor each guard's per-entry `blocking` flag.\n- `warn` — force every guard to non-blocking, so failures surface as warnings but don't halt the agent. Useful for short-term opt-out during a known-broken refactor without editing every entry.\n- `off` — disable all guards regardless of config. Useful for emergency bypass."
          },
          "sidecar.audit.autoApproveReads": {
            "type": "boolean",
            "default": true,
            "order": 23,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Audit Mode, v0.60)* When true (default), `read_file` / `list_directory` calls don't need to go through the audit buffer review — reads don't mutate state, so they pass through even when the agent is running in `audit` mode. Set to `false` to require explicit approval for every read (rarely useful; mostly for auditing sessions where the set of files consulted is itself sensitive)."
          },
          "sidecar.audit.bufferGitCommits": {
            "type": "boolean",
            "default": true,
            "order": 24,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Audit Mode, v0.60)* When true (default), `git_commit` tool calls are buffered alongside file writes so a rejected audit batch leaves `HEAD` unchanged. When false, commits land immediately regardless of audit state — useful for session-tracking commits (changelog entries, audit trail) the user wants to keep even if the code changes are rejected. v0.61 a.4 wires the behavior end-to-end: queued commits execute in FIFO order as the last step of a full flush; subset flushes leave commits queued."
          },
          "sidecar.pr.create.draftByDefault": {
            "type": "boolean",
            "default": true,
            "markdownDescription": "*(Draft PR, v0.68)* When true (default), `SideCar: Create Pull Request (Draft from Branch)` opens PRs as drafts — so CI runs but no reviewer is pinged until you mark ready. Set false to open a ready-for-review PR on the first push."
          },
          "sidecar.pr.create.baseBranch": {
            "type": "string",
            "default": "auto",
            "markdownDescription": "*(Draft PR, v0.68)* Base branch for new PRs. `auto` (default) resolves the remote's default branch via `git symbolic-ref refs/remotes/origin/HEAD`, falling back to `main`. Set to an explicit branch name (e.g. `develop`) to override for repos that target a non-default base."
          },
          "sidecar.pr.create.template": {
            "type": "string",
            "default": "auto",
            "markdownDescription": "*(Draft PR, v0.68)* How to handle repo PR templates. `auto` (default) reads `.github/pull_request_template.md` or `.github/PULL_REQUEST_TEMPLATE.md` and asks the model to fill each section. `ignore` writes a fresh Summary + Test Plan body regardless. Any other value is treated as an absolute/relative path to a custom template file."
          },
          "sidecar.pr.branchProtection.enabled": {
            "type": "boolean",
            "default": true,
            "markdownDescription": "*(Branch Protection Awareness, v0.99)* When true (default), `git_push` checks the target branch's protection rules before pushing. If the branch requires a pull request (i.e. direct pushes are blocked), the push is aborted and the agent is told why — preventing the \"pushed straight to main\" footgun. Disable if your GitHub token lacks `repo` scope or you're pushing to a private fork where the protection rules are irrelevant."
          },
          "sidecar.pr.branchProtection.warnEvenIfPassing": {
            "type": "boolean",
            "default": false,
            "markdownDescription": "*(Branch Protection Awareness, v0.99)* When true, the `git_push` result includes a summary of branch protection rules even when direct pushes ARE allowed — so the agent knows about required status checks and reviewer counts before the PR is submitted. Off by default to keep push output concise."
          },
          "sidecar.codeLens.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Show SideCar code lenses above functions and TODO comments for quick Explain/Fix actions.",
            "requiresWindowReload": true
          }
        }
      },
      {
        "title": "SideCar: Retrieval & Context",
        "properties": {
          "sidecar.contextProviders": {
            "type": "array",
            "default": [],
            "markdownDescription": "External issue-tracker integrations injected into every agent system prompt as an `## Active Issues` block. Each entry configures one provider.\n\n**Supported types:** `github`, `linear`, `jira`, `bitbucket`\n\n**Example:**\n```json\n[\n  {\n    \"type\": \"github\",\n    \"token\": \"ghp_...\",\n    \"project\": \"owner/repo\",\n    \"filter\": \"assigned\",\n    \"maxIssues\": 5\n  },\n  {\n    \"type\": \"linear\",\n    \"token\": \"lin_api_...\",\n    \"filter\": \"assigned\",\n    \"maxIssues\": 5\n  },\n  {\n    \"type\": \"jira\",\n    \"token\": \"...\",\n    \"baseUrl\": \"https://yourco.atlassian.net\",\n    \"project\": \"MYPROJ\",\n    \"filter\": \"assigned\",\n    \"maxIssues\": 5\n  }\n]\n```\n\n**token** — GitHub: Personal Access Token (`ghp_...` or fine-grained). Linear: API key from Linear → Settings → API. Jira: Personal Access Token. ⚠️ Avoid committing tokens — use `${env:MY_TOKEN}` substitution or leave blank and set the `SIDECAR_CTX_TOKEN_GITHUB` / `SIDECAR_CTX_TOKEN_LINEAR` / `SIDECAR_CTX_TOKEN_JIRA` environment variable instead.\n\n**filter** — `assigned` (default): only your open issues. `open`: all open issues in the repo/project. `recent`: recently updated.\n\n**maxIssues** — issues injected per provider (default: 5). Keep low to avoid bloating the context.",
            "items": {
              "type": "object",
              "required": [
                "type",
                "filter",
                "maxIssues"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "github",
                    "linear",
                    "jira",
                    "bitbucket"
                  ]
                },
                "token": {
                  "type": "string",
                  "default": ""
                },
                "baseUrl": {
                  "type": "string",
                  "default": ""
                },
                "project": {
                  "type": "string",
                  "default": ""
                },
                "filter": {
                  "type": "string",
                  "enum": [
                    "assigned",
                    "open",
                    "recent"
                  ],
                  "default": "assigned"
                },
                "maxIssues": {
                  "type": "number",
                  "default": 5,
                  "minimum": 1,
                  "maximum": 20
                }
              }
            }
          },
          "sidecar.includeWorkspace": {
            "type": "boolean",
            "default": true,
            "order": 11,
            "tags": [
              "sidecar",
              "context"
            ],
            "markdownDescription": "Automatically include workspace files in chat context. When off, only files you explicitly reference with `@file:path` or pin with `@pin:path` are sent to the model."
          },
          "sidecar.includeActiveFile": {
            "type": "boolean",
            "default": true,
            "description": "Allow attaching the active file to chat context via the \"add\" toggle. The file is only included when you click add — set this to false to disable the feature entirely."
          },
          "sidecar.filePatterns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "**/*.ts",
              "**/*.tsx",
              "**/*.js",
              "**/*.jsx",
              "**/*.vue",
              "**/*.py",
              "**/*.md",
              "**/*.kt",
              "**/*.kts",
              "**/*.java",
              "**/*.swift",
              "**/*.go",
              "**/*.rs",
              "**/*.c",
              "**/*.cpp",
              "**/*.cc",
              "**/*.cxx",
              "**/*.h",
              "**/*.hpp",
              "**/*.hh",
              "**/*.rb",
              "**/*.php",
              "**/*.cs",
              "**/*.lua",
              "**/*.scala",
              "**/*.dart",
              "**/*.json",
              "**/*.yaml",
              "**/*.yml",
              "**/*.toml",
              "**/*.gradle.kts",
              "**/*.gradle",
              "**/*.html",
              "**/*.css",
              "**/*.scss",
              "**/*.sh",
              "**/*.bash",
              "**/*.zsh",
              "**/*.sql"
            ],
            "order": 12,
            "tags": [
              "sidecar",
              "context"
            ],
            "markdownDescription": "Glob patterns for files eligible to be included as workspace context. Applied before `sidecar.maxFiles` ranks them by relevance. Patterns use standard VS Code globbing (`**`, `*`, `?`)."
          },
          "sidecar.maxFiles": {
            "type": "number",
            "default": 10,
            "minimum": 1,
            "maximum": 100,
            "order": 13,
            "tags": [
              "sidecar",
              "context"
            ],
            "markdownDescription": "Maximum number of workspace files included as context on each turn. Lower this if you're hitting context-limit warnings on a small local model; raise it for frontier models with larger windows."
          },
          "sidecar.contextLimit": {
            "type": "number",
            "default": 0,
            "order": 14,
            "tags": [
              "sidecar",
              "context"
            ],
            "markdownDescription": "Override the context token limit for local models. `0` = auto-detect — uses the value Ollama reports for the model, capped at 128K. Set explicitly (e.g. `32768`) to reduce KV-cache pressure on low-VRAM machines, or raise it beyond 128K for models that support more (some global-attention models carry lower per-model caps). On paid backends the API-reported limit wins; this value is used only when the API reports none."
          },
          "sidecar.pinnedContext": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Files or folders always included in context (relative paths). Use @pin:path in chat to add dynamically."
          },
          "sidecar.projectKnowledge.enabled": {
            "type": "boolean",
            "default": true,
            "order": 25,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Project Knowledge Index, v0.61+)* Symbol-level semantic index. SideCar embeds each function / class / method / interface / type as its own vector (vs. the file-level index's one-vector-per-file) so queries like \"where is auth handled?\" return the specific function rather than the containing file. Uses the existing `@xenova/transformers` MiniLM model — no new downloads, no new dependencies. **Default `true` as of v0.63.** Existing users who set this to `false` explicitly keep their setting; new installs index symbols automatically. First activation re-embeds the workspace (~5–10s on a typical repo); subsequent activations replay the cached index. Disable by setting to `false` if the startup cost bites on very large monorepos (>100k symbols) — the file-level index still works as a fallback.",
            "requiresWindowReload": true
          },
          "sidecar.projectKnowledge.maxSymbolsPerFile": {
            "type": "number",
            "default": 500,
            "order": 26,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Project Knowledge Index, v0.61)* Safety cap on how many symbols from a single file get embedded. Guards against generated files (e.g. auto-generated schemas, giant test fixtures) with tens of thousands of declarations monopolizing the embedder."
          },
          "sidecar.projectKnowledge.backend": {
            "type": "string",
            "enum": [
              "flat",
              "lance"
            ],
            "default": "flat",
            "order": 27,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Project Knowledge Index, v0.62)* Vector storage backend for the symbol embedding index.\n\n- `flat` (default) — in-memory `Float32Array` with linear cosine-scan search. Fast enough for workspaces up to ~100k symbols.\n- `lance` — LanceDB-backed persistent store. Immediately durable (no persist step), handles large indexes that don't fit in memory. `@lancedb/lancedb` (~92 MB native) is **not bundled** with the extension; install it into the extension's runtime yourself to enable this backend. Falls back to `flat` with a warning if the package is absent.\n\nThe backend is swappable without rebuilding the index — both implementations serve the same `VectorStore<M>` interface."
          },
          "sidecar.projectKnowledge.graphWalkDepth": {
            "type": "number",
            "default": 2,
            "minimum": 0,
            "maximum": 4,
            "order": 28,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Project Knowledge Index — graph walk, v0.110)* Max hops to walk the symbol graph from a direct vector hit, for system-prompt retrieval. Set to `0` to disable graph expansion (return only direct cosine-similarity hits). `1` surfaces immediate callers; `2` (default) also surfaces their callers.\n\nHas no effect when `sidecar.retrieval.graphExpansion.enabled` is `false`, and the `project_knowledge_search` TOOL uses its own per-call depth (default 1, max 3) rather than this setting."
          },
          "sidecar.merkleIndex.enabled": {
            "type": "boolean",
            "default": true,
            "order": 30,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(Project Knowledge Index — Merkle layer, v0.62)* Content-addressed hash tree over the symbol embedding index. When on + `sidecar.projectKnowledge.enabled` is also on, every symbol mutation mirrors into a Merkle tree and `project_knowledge_search` prunes candidate files via aggregated-embedding descent *before* scoring leaves — turns an O(total symbols) cosine scan into O(picked files × symbols per file).\n\nDisable only when debugging retrieval regressions: a quality drop against the RAG-eval baseline while this is on isolates the issue to the Merkle layer without losing PKI entirely. The root hash is also exposed (via `getMerkleRoot()` on the index) as a single-value workspace fingerprint for cache validity + cross-machine sync work.",
            "requiresWindowReload": true
          },
          "sidecar.skills.userRegistry": {
            "type": "string",
            "default": "",
            "order": 60,
            "tags": [
              "sidecar",
              "skills"
            ],
            "markdownDescription": "*(Skill Sync — v0.64)* Git URL (or absolute local folder) containing your personal skill collection. On activation, SideCar clones or pulls it into `~/.sidecar/user-skills/` and the SkillLoader picks up every `.agent.md` inside as a user-scope skill. Empty (default) → disabled. Standard git auth applies — SSH keys / gh auth / HTTPS tokens all work."
          },
          "sidecar.skills.teamRegistries": {
            "type": "array",
            "default": [],
            "order": 61,
            "tags": [
              "sidecar",
              "skills"
            ],
            "items": {
              "type": "string"
            },
            "markdownDescription": "*(Skill Sync — v0.64)* Array of git URLs, each cloned into `~/.sidecar/team-skills/<slug>/`. Useful when you belong to multiple teams with overlapping skill collections — the picker tags each skill by its origin registry so you can resolve name collisions deterministically."
          },
          "sidecar.skills.autoPull": {
            "type": "string",
            "enum": [
              "on-start",
              "hourly",
              "daily",
              "manual"
            ],
            "default": "on-start",
            "order": 62,
            "tags": [
              "sidecar",
              "skills"
            ],
            "markdownDescription": "*(Skill Sync — v0.112)* When to pull configured registries. `on-start` refreshes on every activation. `hourly` / `daily` add a background timer that re-syncs without a restart. `manual` only syncs when you run `SideCar: Sync Skill Registries`."
          },
          "sidecar.skills.trustedRegistries": {
            "type": "array",
            "default": [],
            "order": 63,
            "tags": [
              "sidecar",
              "skills",
              "security"
            ],
            "items": {
              "type": "string"
            },
            "markdownDescription": "*(Skill Sync — v0.64)* Registry URLs that skip the first-install trust prompt. Skills from trusted registries still respect per-skill `allowed-tools` / `disable-model-invocation` guardrails; this setting only waives the initial consent modal."
          },
          "sidecar.skills.offline": {
            "type": "boolean",
            "default": false,
            "order": 64,
            "tags": [
              "sidecar",
              "skills"
            ],
            "markdownDescription": "*(Skill Sync — v0.64)* Air-gapped mode. When `true`, SideCar makes no network calls for skill sync — the SkillLoader reads only from what's already cached in `~/.sidecar/{user,team}-skills/`. Useful for restrictive CI environments or when working offline."
          },
          "sidecar.promptPruning.enabled": {
            "type": "boolean",
            "default": true,
            "order": 40,
            "tags": [
              "sidecar",
              "cost"
            ],
            "markdownDescription": "Prune prompts before sending to paid backends (Anthropic, OpenAI). Collapses whitespace, truncates oversized tool results, and dedupes repeated file content. **Safe for agent loops** — only lossy on tool output, never on user or assistant messages.\n\nCheck the savings in `SideCar: Show Session Spend` after each run."
          },
          "sidecar.promptPruning.maxToolResultTokens": {
            "type": "number",
            "default": 4000,
            "minimum": 200,
            "maximum": 20000,
            "order": 41,
            "tags": [
              "sidecar",
              "cost"
            ],
            "markdownDescription": "Maximum token count for any single `tool_result` block sent to a paid backend. Longer results are head+tail truncated with an elision marker. Raise this if you need the agent to see full file contents; lower it to reduce cost on heavy exploration tasks."
          },
          "sidecar.localToolTrim.enabled": {
            "type": "boolean",
            "default": true,
            "order": 42,
            "tags": [
              "sidecar",
              "cost"
            ],
            "markdownDescription": "For **local models** (Ollama/Kickstand), send only the core coding tools (read/edit/search/run/diagnostics) at full schema and compact the rest to one-line stubs the model can expand with `describe_tool`. Cuts ~2.5K tokens of tool schema off every turn and gives small models a clearer 12-tool choice instead of 50+. No effect on cloud backends."
          },
          "sidecar.editFile.resultDiffChars": {
            "type": "number",
            "default": 800,
            "order": 43,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "After a successful `edit_file`, append a bounded diff of what actually changed to the tool result (capped at this many characters), so the model can see — and self-verify — the outcome instead of only `File edited: <path>`. Helps weak local models catch wrong-but-applied edits. Set to `0` to disable."
          },
          "sidecar.zenMode.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable Zen Mode context filtering. When on, only RAG hits scoring at or above sidecar.zenMode.minScore are injected into the system prompt — reduces noise for local models on focused tasks."
          },
          "sidecar.zenMode.minScore": {
            "type": "number",
            "default": 0.35,
            "minimum": 0,
            "maximum": 1,
            "description": "Minimum RRF score for a retrieved context hit to be included when Zen Mode is enabled. 0 disables filtering even when zenMode.enabled is true."
          },
          "sidecar.monorepo.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable monorepo package discovery. When on, SideCar auto-detects Nx, Turborepo, pnpm, yarn-workspaces, and Lerna layouts and exposes a `monorepo_packages` tool so the agent can enumerate packages and scope `project_knowledge_search` to a single package via `pathPrefix`.",
            "requiresWindowReload": true
          },
          "sidecar.voice.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable voice input. Shows a microphone button in the chat input area. Click once to start recording, click again to stop. Audio is sent to a Whisper-compatible transcription endpoint and the result is injected into the chat input box."
          },
          "sidecar.voice.model": {
            "type": "string",
            "default": "Xenova/whisper-tiny",
            "description": "Whisper model for speech-to-text. HuggingFace hub IDs (containing '/') run in-process via ONNX — no API key needed (e.g. `Xenova/whisper-tiny` ~75 MB, `Xenova/whisper-base` ~145 MB). Plain names like `whisper-1` or `whisper-large-v3-turbo` use the HTTP transcriptions API (OpenAI / Groq)."
          },
          "sidecar.voice.transcriptionUrl": {
            "type": "string",
            "default": "",
            "description": "Override URL for the Whisper transcription endpoint. Leave empty to derive from the active backend's base URL (`{baseUrl}/audio/transcriptions`). Useful when transcription runs on a different server than the chat model (e.g. a local whisper.cpp instance)."
          },
          "sidecar.ci.analysis.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable the `analyze_ci_failure` agent tool. When enabled, the agent can fetch and parse GitHub Actions logs for the most recent failed run on the current branch, trimming the output down to the relevant failure context.",
            "requiresWindowReload": true
          },
          "sidecar.ci.analysis.maxLogBytes": {
            "type": "number",
            "default": 4000000,
            "description": "Maximum bytes to download per CI job log. Logs larger than this are tailed (the end of the log is kept, since failures appear there). Minimum 100 000. Default 4 MB."
          },
          "sidecar.ci.analysis.jobFilter": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "*"
            ],
            "description": "Glob patterns matched against CI job names. Only jobs whose names match at least one pattern are analyzed by `analyze_ci_failure`. Use `[\"*\"]` to analyze all failed jobs, or narrow to e.g. `[\"test\", \"lint\"]`."
          },
          "sidecar.jsDocSync.enabled": {
            "type": "boolean",
            "default": true,
            "description": "On save, check TypeScript / JavaScript files for JSDoc @param tags that no longer match the function signature. Stale tags are surfaced as diagnostics with quick-fix actions to add, remove, or rename them."
          },
          "sidecar.readmeSync.enabled": {
            "type": "boolean",
            "default": true,
            "description": "On save and open, check fenced code blocks in README.md for calls to workspace-exported functions whose argument count no longer matches the current signature. Stale calls are surfaced as diagnostics with a quick-fix that rewrites the arguments."
          }
        }
      },
      {
        "title": "SideCar: Shadow Workspace & Terminal",
        "properties": {
          "sidecar.shadowWorkspace.mode": {
            "type": "string",
            "enum": [
              "off",
              "opt-in",
              "always"
            ],
            "default": "off",
            "order": 18,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Controls the Shadow Workspace feature — a git-worktree sandbox at `.sidecar/shadows/<task-id>/` where the agent iterates without touching the main working tree. On task completion, the user sees a diff and can accept (apply to main) or reject (discard).\n\n- `off` (default) — disabled. Agent writes land directly in main.\n- `opt-in` — agent tasks run in the main tree; opt a specific task into a shadow with `/sandbox <task>` in chat. (An explicit `/sandbox` request shadows the task in any mode, including `off`.)\n- `always` — every agent task runs in a shadow. Safe but introduces per-task setup cost (worktree checkout) and a review step at end.\n\nStill open on this feature: per-hunk review UI, gate-command integration (`shadowWorkspace.gateCommand` is declared but not yet run), symlinked build dirs, and rebase-on-moved-main conflict handling."
          },
          "sidecar.shadowWorkspace.autoCleanup": {
            "type": "boolean",
            "default": true,
            "order": 19,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "When true, `git worktree remove` + directory cleanup run after every shadow regardless of accept/reject. Set to `false` to keep failed or rejected shadows around for post-mortem inspection at `.sidecar/shadows/<task-id>/` — useful when debugging why the agent's shadow work didn't apply cleanly."
          },
          "sidecar.shadowWorkspace.gateCommand": {
            "type": "string",
            "default": "npm run check",
            "order": 20,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Shell command intended to run inside the shadow before the accept/reject prompt opens, so failing builds can't ship as accepted diffs. Override for non-JS projects (e.g. `cargo check && cargo test`, `pytest && mypy`).\n\n**Not yet wired** — shadow runs currently go straight to the accept/reject prompt without running this command. The setting is declared so the gate can land zero-config when wired."
          },
          "sidecar.shadowWorkspace.sweepStaleOnActivation": {
            "type": "boolean",
            "default": true,
            "order": 20,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(v0.62.1)* Sweep orphan shadow worktrees at activation. A VS Code crash mid-shadow-run can leave git metadata under `.git/worktrees/<id>/` pointing at a directory that no longer exists — downstream `git status` / `git fetch` / `git push` start failing mysteriously. When enabled (default), SideCar runs `git worktree remove --force` on any stale entry whose shadow path is gone + deletes orphan dirs under `.sidecar/shadows/` that aren't registered with git.\n\nDisable when doing crash-recovery forensics on your own shadows; the manual `SideCar: Shadow Workspaces: Sweep Stale Worktrees` command stays available regardless of this setting."
          },
          "sidecar.sandbox.enabled": {
            "type": "boolean",
            "default": true,
            "order": 13,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "*(macOS only)* Wrap agent shell commands (`run_command`, `run_tests`, background commands) in the macOS Seatbelt sandbox via `/usr/bin/sandbox-exec`. The profile allows all file reads, network access, and process execution, but restricts **writes** to the workspace directory, `/tmp`, and common build-tool caches (`~/.npm`, `~/.cargo`, `~/.cache`, etc.). Writes to sensitive paths such as `~/.ssh`, `~/.aws`, `/etc`, and `/usr/local` are denied.\n\nHas no effect on Linux or Windows. The VS Code terminal-integration path (`sidecar.terminalExecution.enabled`) is not sandboxed — VS Code creates that process outside SideCar's spawn call.\n\nDisable if you need agent shell commands to write outside these paths (e.g. system-wide Homebrew installs)."
          },
          "sidecar.terminalExecution.enabled": {
            "type": "boolean",
            "default": true,
            "order": 14,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Route the agent's `run_command` tool through VS Code's shell-integration API so the user sees commands execute in a dedicated *SideCar Agent* terminal (as opposed to the hidden `child_process.spawn` path `ShellSession` used previously). Gives transparency on SSH / Dev Containers / WSL / Codespaces where `child_process.exec` escapes the remote sandbox. Set to `false` to keep everything on `ShellSession`."
          },
          "sidecar.terminalExecution.terminalName": {
            "type": "string",
            "default": "SideCar Agent",
            "order": 15,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Display name for the reusable agent terminal when `terminalExecution.enabled` is true."
          },
          "sidecar.terminalExecution.fallbackToChildProcess": {
            "type": "boolean",
            "default": true,
            "order": 16,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "When shell integration is unavailable (bare shell without the VS Code init script, older VS Code version), fall back to the `ShellSession` / `child_process` execution path. Set to `false` to make commands fail loudly instead of silently falling back — useful for debugging terminal-integration setup issues."
          },
          "sidecar.terminalExecution.shellIntegrationTimeoutMs": {
            "type": "number",
            "default": 2000,
            "minimum": 100,
            "maximum": 10000,
            "order": 17,
            "tags": [
              "sidecar"
            ],
            "markdownDescription": "Milliseconds to wait for `shellIntegration` to attach to a freshly created terminal before falling back to `ShellSession`. Shell integration attaches asynchronously after the terminal's shell loads VS Code's init script, so a short wait is normal. Raise if your shell startup is slow; lower to fail faster on shells that won't ever integrate."
          },
          "sidecar.terminalErrorInterception": {
            "type": "boolean",
            "default": true,
            "description": "Detect non-zero exit codes in the integrated terminal and offer to diagnose the failure in the SideCar chat. Requires VS Code shell integration."
          }
        }
      },
      {
        "title": "SideCar: Inline Completions",
        "properties": {
          "sidecar.enableInlineCompletions": {
            "type": "boolean",
            "default": false,
            "description": "Enable inline code completions (Copilot-like autocomplete)"
          },
          "sidecar.completionModel": {
            "type": "string",
            "default": "",
            "description": "Model for inline completions (leave empty to use the chat model)"
          },
          "sidecar.completionDraftModel": {
            "type": "string",
            "default": "",
            "description": "Explicit draft model for speculative FIM completions (Ollama + Kickstand). When set, completions race this model against the main model. Leave empty to auto-detect from the built-in DRAFT_MODEL_MAP."
          },
          "sidecar.speculativeDecoding.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable speculative FIM decoding. When the active model has a curated draft pair (or completionDraftModel is set), completions race the draft against the main model and return whichever finishes first."
          },
          "sidecar.speculativeDecoding.minAcceptRateToKeepEnabled": {
            "type": "number",
            "default": 0.4,
            "minimum": 0,
            "maximum": 1,
            "description": "Minimum fraction of completions the draft model must win before speculative decoding is auto-disabled for the session. Only enforced after 10 warmup completions."
          },
          "sidecar.completionMaxTokens": {
            "type": "number",
            "default": 256,
            "description": "Maximum tokens for inline completion responses"
          },
          "sidecar.completionDebounceMs": {
            "type": "number",
            "default": 300,
            "description": "Minimum interval in milliseconds between completion requests"
          },
          "sidecar.adaptivePaste.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable Adaptive Paste — when you paste foreign content (SQL, JSON, curl, Python, shell, .env) into a file, SideCar offers a lightbulb action to transform it to fit the target language.",
            "requiresWindowReload": true
          },
          "sidecar.adaptivePaste.minPasteLength": {
            "type": "number",
            "default": 50,
            "minimum": 20,
            "maximum": 2000,
            "description": "Minimum character count for a text insertion to be treated as a paste. Keeps the tracker from firing on short typed snippets."
          },
          "sidecar.adaptivePaste.model": {
            "type": "string",
            "default": "",
            "description": "Model override for paste transformations (leave empty to use the chat model)."
          },
          "sidecar.adaptivePaste.autoDetect": {
            "type": "boolean",
            "default": true,
            "description": "Automatically detect paste events via document change tracking. When false, only the explicit 'Transform Paste' command is available."
          },
          "sidecar.nextEdit.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable Next Edit Suggestions — after you edit a symbol, SideCar analyses the symbol graph and highlights callers/dependents that likely need a follow-on change.",
            "requiresWindowReload": true
          },
          "sidecar.nextEdit.debounceMs": {
            "type": "number",
            "default": 600,
            "minimum": 100,
            "maximum": 5000,
            "description": "Debounce delay in milliseconds before the next-edit analyser runs after a document change."
          },
          "sidecar.nextEdit.maxHops": {
            "type": "number",
            "default": 2,
            "minimum": 1,
            "maximum": 4,
            "description": "How many graph hops to walk when searching for next edit sites. 1 = direct callers only; 2 = also files that import the changed file."
          },
          "sidecar.nextEdit.topK": {
            "type": "number",
            "default": 3,
            "minimum": 1,
            "maximum": 9,
            "description": "Maximum number of next-edit suggestions to surface at once."
          },
          "sidecar.nextEdit.crossFileEnabled": {
            "type": "boolean",
            "default": true,
            "description": "Include suggestions in files other than the one being edited."
          },
          "sidecar.nextEdit.model": {
            "type": "string",
            "default": "",
            "description": "Reserved — currently has NO effect. Next Edit ranking is a pure symbol-graph walk with no LLM call; this setting exists for a future release that adds LLM-ranked patch previews."
          },
          "sidecar.nextEdit.autoTriggerOnSave": {
            "type": "boolean",
            "default": false,
            "description": "Also run the next-edit analyser when the file is saved, in addition to debounced keystroke triggers."
          }
        }
      },
      {
        "title": "SideCar: Diagnostics & Thinking",
        "properties": {
          "sidecar.diagnostics.reactiveFixEnabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable reactive diagnostic fixing — automatically propose fixes for new errors and warnings"
          },
          "sidecar.diagnostics.reactiveFixDebounceMs": {
            "type": "number",
            "default": 2000,
            "description": "Debounce period in milliseconds before firing a reactive diagnostic fix"
          },
          "sidecar.diagnostics.reactiveFixSeverity": {
            "type": "string",
            "enum": [
              "error",
              "warning"
            ],
            "enumDescriptions": [
              "Only fix errors",
              "Fix both errors and warnings"
            ],
            "default": "error",
            "description": "Minimum diagnostic severity to trigger reactive fixing"
          },
          "sidecar.thinking.mode": {
            "type": "string",
            "enum": [
              "single",
              "self-debate",
              "tree-of-thought",
              "red-team"
            ],
            "enumDescriptions": [
              "Plain label — default",
              "Label only: does NOT alter prompts or make the model debate itself",
              "Label only: does NOT restructure the model's thinking",
              "Label only: does NOT trigger adversarial critique"
            ],
            "default": "single",
            "description": "Label stamped into the frontmatter of saved thinking logs (.sidecar/thinking/*.md) for any backend that emits thinking events. This is metadata for organizing your logs — it does not change prompts, add turns, or alter model behavior."
          },
          "sidecar.pinnedMemory.enabled": {
            "type": "boolean",
            "default": true,
            "requiresWindowReload": true,
            "description": "Enable pinned memory — content you pin via 'Pin to Memory' is always injected into the system prompt regardless of query relevance, and survives context compaction."
          },
          "sidecar.pinnedMemory.maxPins": {
            "type": "number",
            "default": 50,
            "minimum": 1,
            "maximum": 200,
            "description": "Maximum number of pinned memory entries. Higher-boost entries land first; entries beyond the cap are silently dropped from injection."
          },
          "sidecar.pinnedMemory.maxCharsPerPin": {
            "type": "number",
            "default": 5000,
            "minimum": 500,
            "maximum": 20000,
            "description": "Maximum characters per pinned entry injected into the system prompt. Entries exceeding this are truncated with a marker (not dropped)."
          },
          "sidecar.diagnostics.analysisBudgetMs": {
            "type": "number",
            "default": 5000,
            "minimum": 0,
            "maximum": 30000,
            "markdownDescription": "How long `get_diagnostics` waits for a language server to analyze the file it was asked about.\n\nVS Code only reports diagnostics for files a language server has open, so a file the agent just wrote to disk has none — the tool used to return \"No diagnostics\" for the exact case it exists to serve. It now opens the file in a **preview tab that does not take focus**, waits for the analysis, and closes the tab again. Nothing is saved and no editor is left dirty; the visible cost is a tab that briefly appears.\n\nSet to `0` to skip this entirely and read only what is already cached — faster and completely invisible, but the result will usually be empty for files you have not opened yourself."
          }
        }
      },
      {
        "title": "SideCar: Chat UI",
        "properties": {
          "sidecar.chatDensity": {
            "type": "string",
            "enum": [
              "compact",
              "normal",
              "comfortable"
            ],
            "enumDescriptions": [
              "Tighter message padding and gaps — fits more messages on screen, good for side-by-side layouts.",
              "The default — balanced padding matching VS Code's overall density.",
              "Relaxed padding and larger gaps — easier reading on high-DPI displays."
            ],
            "default": "normal",
            "order": 53,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Chat panel density. Affects message padding, avatar size, and vertical rhythm — not the font size (use `#sidecar.chatFontSize#` for that)."
          },
          "sidecar.chatFontSize": {
            "type": "number",
            "default": 13,
            "minimum": 10,
            "maximum": 22,
            "order": 54,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Chat UI base font size in pixels. Range: 10–22."
          },
          "sidecar.chatAccentColor": {
            "type": "string",
            "default": "",
            "order": 55,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Override the chat accent color used for user messages and step indicators. Any valid CSS color (`#ffbb00`, `hsl(200 80% 50%)`, `royalblue`). Leave empty to inherit from the active VS Code theme."
          },
          "sidecar.enableMermaid": {
            "type": "boolean",
            "default": true,
            "order": 52,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Render fenced ` ```mermaid ` code blocks as diagrams in the chat. Disable to skip the 5.2MB mermaid.js load and render them as plain code — useful if you never ask for diagrams and want a smaller runtime footprint."
          },
          "sidecar.expandThinking": {
            "type": "boolean",
            "default": false,
            "order": 51,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Show model reasoning (`<thinking>`) blocks expanded by default instead of collapsed. Useful when watching how frontier models reason, noisy for everyday chat."
          },
          "sidecar.verboseMode": {
            "type": "boolean",
            "default": true,
            "order": 50,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Show detailed agent reasoning in the chat — iteration summaries, tool selection context, and system prompt assembly. Turn off for a quieter UI at the cost of debuggability."
          },
          "sidecar.verboseLogs": {
            "type": "boolean",
            "default": false,
            "order": 51,
            "tags": [
              "sidecar",
              "ui"
            ],
            "markdownDescription": "Append per-turn API call metadata `{ runId, model, inputTokens, outputTokens, stopReason, timestamp }` to `.sidecar/logs/api.jsonl` for auditing and cost tracking."
          }
        }
      },
      {
        "title": "SideCar: Extensions & Automation",
        "properties": {
          "sidecar.autoMode.backlogPath": {
            "type": "string",
            "default": ".sidecar/backlog.md",
            "description": "Path to the backlog file Auto Mode reads. Relative paths are resolved from the workspace root."
          },
          "sidecar.autoMode.maxTasksPerSession": {
            "type": "number",
            "default": 10,
            "minimum": 1,
            "maximum": 100,
            "description": "Maximum number of backlog items to attempt in a single Auto Mode session."
          },
          "sidecar.autoMode.maxRuntimeMinutes": {
            "type": "number",
            "default": 240,
            "minimum": 1,
            "maximum": 1440,
            "description": "Wall-clock time limit for an Auto Mode session in minutes. The session stops when this limit is reached, even if items remain."
          },
          "sidecar.autoMode.haltOnFailure": {
            "type": "boolean",
            "default": false,
            "description": "When true, Auto Mode stops after the first task that fails. When false, it logs the failure and moves on to the next item."
          },
          "sidecar.autoMode.autoOpenPR": {
            "type": "boolean",
            "default": true,
            "description": "Automatically open a pull request after each successfully completed task. Requires the repository to have a remote configured."
          },
          "sidecar.autoMode.interTaskCooldownSeconds": {
            "type": "number",
            "default": 30,
            "minimum": 0,
            "maximum": 300,
            "description": "Seconds to wait between tasks in an Auto Mode session. Gives you a window to stop the session before the next task begins."
          },
          "sidecar.literature.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Include indexed PDF literature (from .sidecar/literature/) in retrieval context. Use index_pdf to add papers first."
          },
          "sidecar.notebookMode.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable Notebook Mode source-grounded research tools: ingest_source, generate_briefing, generate_study_guide, generate_faq, generate_timeline, generate_outline. Each artifact carries per-sentence citations back to the ingested source.",
            "requiresWindowReload": true
          },
          "sidecar.notebookMode.requireCitations": {
            "type": "string",
            "enum": [
              "strict",
              "advisory",
              "off"
            ],
            "enumDescriptions": [
              "Artifacts are rejected and re-generated if they contain uncited claims.",
              "Uncited claims trigger a warning but the artifact is still accepted.",
              "Citation requirements are not enforced."
            ],
            "default": "strict",
            "description": "How strictly Notebook Mode enforces source citations in generated artifacts."
          },
          "sidecar.notebookMode.studyAids.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable the generate_study_guide and generate_faq Notebook Mode tools. Disable to keep only the core ingest + briefing + outline pipeline."
          },
          "sidecar.notebookMode.sources.webUrl": {
            "type": "boolean",
            "default": true,
            "description": "Allow Notebook Mode to ingest sources from web URLs via ingest_source."
          },
          "sidecar.zotero.userId": {
            "type": "string",
            "default": "",
            "description": "Your Zotero user ID (found at zotero.org/settings/keys). Required for zotero_search and zotero_get_item tools."
          },
          "sidecar.zotero.apiKey": {
            "type": "string",
            "default": "",
            "description": "Your Zotero API key with read access (zotero.org/settings/keys). Required for zotero_search and zotero_get_item tools."
          },
          "sidecar.zotero.baseUrl": {
            "type": "string",
            "default": "https://api.zotero.org",
            "description": "Zotero API base URL. Override for self-hosted Zotero instances; leave blank for the default cloud API."
          },
          "sidecar.mcpServers": {
            "type": "object",
            "default": {},
            "markdownDescription": "MCP servers to connect to. Supports stdio, HTTP, and SSE transports. Also reads `.mcp.json` at workspace root.\n\n**stdio:** `{ \"command\": \"npx\", \"args\": [\"server\"] }`\n\n**HTTP:** `{ \"type\": \"http\", \"url\": \"https://...\", \"headers\": {} }`\n\n**Options:** `tools` (per-tool enable/disable), `toolAllowlist`, `maxResultChars` (output limit, default 50000), `alwaysLoad` (inject full tool schemas upfront; default lazy — one-line stubs, model fetches schemas via describe_tool)"
          },
          "sidecar.customTools": {
            "type": "array",
            "default": [],
            "description": "Custom tools that run shell commands. Format: [{ \"name\": \"...\", \"description\": \"...\", \"command\": \"...\" }]",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "command": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "description",
                "command"
              ]
            }
          },
          "sidecar.customModes": {
            "type": "array",
            "default": [],
            "description": "Custom agent modes with dedicated system prompts and approval behavior. Example: [{ \"name\": \"architect\", \"description\": \"Design-only mode\", \"systemPrompt\": \"Focus on architecture...\", \"approvalBehavior\": \"manual\" }]",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Mode identifier (lowercase, no spaces)"
                },
                "description": {
                  "type": "string",
                  "description": "Short description shown in the mode dropdown"
                },
                "systemPrompt": {
                  "type": "string",
                  "description": "Additional system prompt text injected when this mode is active"
                },
                "approvalBehavior": {
                  "type": "string",
                  "enum": [
                    "autonomous",
                    "cautious",
                    "manual"
                  ],
                  "description": "Tool approval behavior for this mode"
                },
                "toolPermissions": {
                  "type": "object",
                  "default": {},
                  "description": "Per-tool permission overrides for this mode",
                  "additionalProperties": {
                    "type": "string",
                    "enum": [
                      "allow",
                      "deny",
                      "ask"
                    ]
                  }
                }
              },
              "required": [
                "name",
                "description",
                "systemPrompt",
                "approvalBehavior"
              ]
            }
          },
          "sidecar.hooks": {
            "type": "object",
            "default": {},
            "description": "Pre/post-execution hooks by tool name. Keys are tool names or '*' for all. Value: { \"pre\": \"command\", \"post\": \"command\" }"
          },
          "sidecar.eventHooks": {
            "type": "object",
            "default": {},
            "description": "Event-based hooks. { \"onSave\": \"command\", \"onCreate\": \"command\", \"onDelete\": \"command\" }",
            "properties": {
              "onSave": {
                "type": "string"
              },
              "onCreate": {
                "type": "string"
              },
              "onDelete": {
                "type": "string"
              }
            }
          },
          "sidecar.scheduledTasks": {
            "type": "array",
            "default": [],
            "description": "Recurring agent tasks. Each task runs on an interval, a cron schedule, or when a file matching onSave globs is saved. Run any task immediately via the 'SideCar: Run Scheduled Task Now' command.",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Human-readable task name (also used as the lock key — must be unique)"
                },
                "intervalMinutes": {
                  "type": "number",
                  "minimum": 1,
                  "description": "Run every N minutes. Ignored if `cron` is set."
                },
                "cron": {
                  "type": "string",
                  "description": "5-field cron expression (minute hour day month weekday). Example: '0 9 * * 1-5' = weekdays at 09:00. Takes precedence over intervalMinutes."
                },
                "onSave": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Run whenever a saved file matches any of these glob patterns. Example: ['src/**/*.ts', 'package.json']"
                },
                "prompt": {
                  "type": "string",
                  "description": "Natural language task prompt sent to the agent"
                },
                "enabled": {
                  "type": "boolean",
                  "default": true,
                  "description": "Set to false to disable without removing the entry"
                },
                "targetPaths": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "File paths this task may write. If any are unsaved when the task fires, it runs in a Shadow Workspace for safety."
                }
              },
              "required": [
                "name",
                "prompt"
              ]
            }
          },
          "sidecar.delegateTask.enabled": {
            "type": "boolean",
            "default": true,
            "order": 42,
            "tags": [
              "sidecar",
              "cost",
              "agent"
            ],
            "markdownDescription": "Expose the `delegate_task` tool when the provider is Anthropic or OpenAI. The orchestrator can offload read-only research (file reads, greps, searches) to a local Ollama worker and receive a compact summary, cutting paid-model token usage on heavy exploration tasks. **Not offered on other backends** (incl. OpenRouter/Groq/Fireworks/Gemini/Bedrock) or local-only setups."
          },
          "sidecar.delegateTask.workerModel": {
            "type": "string",
            "default": "",
            "order": 43,
            "tags": [
              "sidecar",
              "cost",
              "agent"
            ],
            "markdownDescription": "Ollama model used by the `delegate_task` worker. Empty string = reuse the chat model. Recommended: a code-tuned model like `qwen3-coder:30b` or `deepseek-coder:33b`."
          },
          "sidecar.delegateTask.workerBaseUrl": {
            "type": "string",
            "default": "http://localhost:11434",
            "order": 44,
            "tags": [
              "sidecar",
              "cost",
              "agent"
            ],
            "markdownDescription": "Base URL of the Ollama instance the `delegate_task` worker connects to. Must point at a local or reachable Ollama server — never Anthropic or OpenAI (defeats the purpose)."
          },
          "sidecar.delegateTask.maxIterations": {
            "type": "number",
            "default": 10,
            "minimum": 1,
            "maximum": 25,
            "order": 45,
            "tags": [
              "sidecar",
              "cost",
              "agent"
            ],
            "markdownDescription": "Hard cap on agent iterations for a delegated worker run. Workers are scoped to focused read-only research, so a tight cap protects against runaway loops and unintended cost. Raise this only if your delegated tasks legitimately need more steps (e.g. deep multi-file analysis). The main agent loop is bounded separately by `#sidecar.agentMaxIterations#`."
          },
          "sidecar.outboundAllowlist": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "order": 4,
            "tags": [
              "sidecar",
              "security"
            ],
            "markdownDescription": "Outbound host allowlist for URL fetching in chat.\n\nWhen non-empty, SideCar only fetches URLs whose hostname matches one of these entries. Empty (the default) allows every public URL — SSRF and private-IP blocking still apply.\n\nPatterns support a leading `*.` wildcard for subdomains:\n\n- `github.com` — exact match only\n- `*.github.com` — any subdomain (`api.github.com`, `raw.github.com`)\n\nPairs with the built-in exfiltration defense on `web_search`, which refuses to send queries containing credential-shaped tokens regardless of this setting."
          },
          "sidecar.fetchUrlContext": {
            "type": "boolean",
            "default": true,
            "order": 15,
            "tags": [
              "sidecar",
              "context"
            ],
            "markdownDescription": "Automatically fetch web-page content when URLs are pasted into chat. The fetched HTML is converted to markdown and attached as context on the next turn."
          }
        }
      },
      {
        "title": "SideCar: Databases",
        "properties": {
          "sidecar.databases.profiles": {
            "type": "array",
            "default": [],
            "markdownDescription": "Database connection profiles for the `db_list_tables` / `db_describe_table` / `db_query` tools. Each entry: `{ id, name, dialect, filePath?, host?, port?, database?, user?, secretKey?, readOnly? }`. Passwords are stored in VS Code SecretStorage keyed by `secretKey` — never put passwords in this setting.",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "dialect"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Unique identifier for this connection"
                },
                "name": {
                  "type": "string",
                  "description": "Display name"
                },
                "dialect": {
                  "type": "string",
                  "enum": [
                    "sqlite",
                    "postgres",
                    "mysql",
                    "duckdb"
                  ],
                  "description": "Database dialect"
                },
                "filePath": {
                  "type": "string",
                  "description": "File path for SQLite / DuckDB databases"
                },
                "host": {
                  "type": "string",
                  "description": "Hostname for Postgres / MySQL"
                },
                "port": {
                  "type": "number",
                  "description": "Port number (default: 5432 for Postgres, 3306 for MySQL)"
                },
                "database": {
                  "type": "string",
                  "description": "Database / schema name"
                },
                "user": {
                  "type": "string",
                  "description": "Username"
                },
                "secretKey": {
                  "type": "string",
                  "description": "VS Code SecretStorage key where the password is stored"
                },
                "readOnly": {
                  "type": "boolean",
                  "default": true,
                  "description": "Open connection in read-only mode (default: true)"
                }
              }
            }
          },
          "sidecar.databases.queryTimeoutMs": {
            "type": "number",
            "default": 30000,
            "minimum": 1000,
            "description": "Hard timeout in milliseconds applied to every db_query call. Prevents runaway queries from locking the session."
          },
          "sidecar.databases.queryRowLimit": {
            "type": "number",
            "default": 10000,
            "minimum": 1,
            "description": "Maximum number of rows returned by db_query. Results beyond this limit are truncated (truncated: true in the result)."
          }
        }
      },
      {
        "title": "SideCar: Visual Verification",
        "properties": {
          "sidecar.visualVerify.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the screenshot-in-the-loop visual verification tools (screenshot_page, analyze_screenshot, open_in_browser, run_playwright_code). Requires a vision-capable model and playwright-core installed in the extension host.",
            "requiresWindowReload": true
          },
          "sidecar.visualVerify.vlm": {
            "type": "string",
            "default": "",
            "description": "Vision model to use for analyze_screenshot. Leave empty to auto-detect from the active backend (Claude 3+, GPT-4o, or Ollama vision models like llava). Example: \"claude-sonnet-4-6\" or \"llava\"."
          },
          "sidecar.visualVerify.screenshotsDir": {
            "type": "string",
            "default": ".sidecar/screenshots",
            "description": "Directory where screenshot_page saves captured PNGs. Relative to workspace root. New workspaces get a `screenshots/` entry in the auto-created .sidecar/.gitignore; in an existing workspace add it yourself if you don't want captures committed."
          },
          "sidecar.visualVerify.maxAttempts": {
            "type": "number",
            "default": 3,
            "minimum": 1,
            "description": "Suggested maximum number of visual-correction attempts the agent should make before giving up. Injected into the agent system prompt as guidance when visualVerify.enabled is true."
          },
          "sidecar.visualVerify.mode": {
            "type": "string",
            "enum": [
              "strict",
              "warn",
              "advisory"
            ],
            "default": "warn",
            "markdownDescription": "How the agent should treat visual verification failures. `strict` — treat failures as blocking errors; `warn` (default) — surface failures but continue; `advisory` — informational only, never blocks."
          },
          "sidecar.visualVerify.cheapChecksOnly": {
            "type": "boolean",
            "default": false,
            "description": "Run only the heuristic pre-filter checks (blank canvas, edge clipping) and skip the VLM call entirely. Useful on tight local-inference budgets."
          },
          "sidecar.visualVerify.allowedDomains": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "markdownDescription": "Domains or hostnames that are permitted for `screenshot_page` even when they resolve to a loopback or private-network address (e.g. `localhost`, `192.168.1.1`). Use this to allow local dev servers."
          }
        }
      },
      {
        "title": "SideCar: Doc-to-Test",
        "properties": {
          "sidecar.docTests.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable the Doc-to-Test Synthesis Loop tools (extract_constraints, synthesize_tests, classify_test_failure). When disabled, these tools are hidden from the agent catalog.",
            "requiresWindowReload": true
          },
          "sidecar.docTests.outputDir": {
            "type": "string",
            "default": "tests/from_docs",
            "description": "Directory where synthesized test files are written (relative to workspace root). Files land at <outputDir>/<docSlug>/test_<docSlug>.py."
          },
          "sidecar.docTests.floatTolerance": {
            "type": "number",
            "default": 1e-9,
            "description": "Default relative tolerance passed to pytest.approx() for numeric_example constraints."
          },
          "sidecar.docTests.extractionModel": {
            "type": "string",
            "default": "",
            "description": "Optional model override for constraint extraction. Leave empty to use the active model. Set to a cheaper/faster model (e.g. claude-haiku-4-5) to reduce cost on large documents."
          },
          "sidecar.docTests.requireConstraintApproval": {
            "type": "boolean",
            "default": true,
            "description": "When true, the agent presents the constraint manifest for review before calling synthesize_tests. When false, the agent synthesizes tests immediately after extraction."
          }
        }
      },
      {
        "title": "SideCar: Dependencies",
        "properties": {
          "sidecar.deps.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Enable Dependency Drift Alerts — scans package.json, requirements.txt, Cargo.toml, and go.mod for outdated and vulnerable dependencies. Findings appear in the Problems panel and via the check_dependencies agent tool.",
            "requiresWindowReload": true
          },
          "sidecar.deps.checkVulnerabilities": {
            "type": "boolean",
            "default": true,
            "description": "Query the OSV (Open Source Vulnerabilities) API when scanning dependencies. Requires internet access. Disable for offline or air-gapped environments."
          },
          "sidecar.research.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the Research Assistant. Provides research_create_project, research_add_hypothesis, research_log_experiment, and research_add_observation agent tools. Projects are stored under .sidecar/research/ and tracked in git.",
            "requiresWindowReload": true
          },
          "sidecar.research.activeProject": {
            "type": "string",
            "default": "",
            "description": "Slug of the active research project. When set, research tools default to this project."
          },
          "sidecar.profiling.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the profile_code agent tool. Profiles Node.js (--prof), Python (cProfile), Go (go test -bench), and Rust (cargo bench) projects and returns top-N CPU hotspots.",
            "requiresWindowReload": true
          },
          "sidecar.mutation.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the mutation_test agent tool (verify-the-verifier). Seeds single-point faults into a source file and reports which mutants SURVIVE the test suite — proof the tests would miss that class of bug. Requires a green baseline; runs the test command once per mutant (bounded by sidecar.mutation.maxMutants).",
            "requiresWindowReload": true
          },
          "sidecar.mutation.maxMutants": {
            "type": "number",
            "default": 25,
            "minimum": 1,
            "maximum": 500,
            "description": "Cap on the number of mutants generated and tested per mutation_test run (bounds runtime — the test command runs once per mutant)."
          },
          "sidecar.mutation.testTimeoutMs": {
            "type": "number",
            "default": 60000,
            "minimum": 1000,
            "maximum": 600000,
            "description": "Per-test-run timeout (ms) for each mutant in mutation_test. A mutant whose test run times out is counted as errored, not killed."
          },
          "sidecar.codeGraph.impactGate": {
            "type": "boolean",
            "default": false,
            "markdownDescription": "Block completion when the agent edits an exported symbol that has unverified cross-file dependents. Uses the symbol graph's import-resolved change-impact analysis (the same data behind the `analyze_impact` tool) to require the agent verify downstream callers/type-users still hold before finishing. Off by default: the impact summary is always shown as a non-blocking advisory regardless of this setting; turning it on promotes that advisory to a one-time hard block when the edited symbols weren't covered by a passing test."
          },
          "sidecar.numericalContracts.gate": {
            "type": "boolean",
            "default": false,
            "markdownDescription": "Block completion when the agent edits a numerical kernel (a function with array/tensor/quantity-typed parameters or returns, e.g. `np.ndarray`) that lacks a shape/dtype/unit contract — a shaped type annotation, a `assert arr.shape == …` / dtype check, or a docstring shape spec. Uses the code graph's type-flow edges (the same data behind the `check_numerical_contracts` tool). Off by default: an advisory listing uncontracted kernels always shows when numerical code is edited; turning this on promotes it to a one-time hard block so a green test suite can't pass over a bare, unconstrained array contract."
          },
          "sidecar.analyticBounds.gate": {
            "type": "boolean",
            "default": false,
            "markdownDescription": "Block completion when the agent edits a kernel that DECLARES an analytic value bound — e.g. `# bounds: 0 <= result <= 1` (a probability), `# bounds: result >= 0` (energy/norm), or `# invariant: sum(result) == 1` — but nothing in the code enforces it (no assertion, clip, or raise). Shape contracts prove the array is the right shape; analytic bounds prove the *values* are physically admissible. Off by default: an advisory always shows the unenforced bounds with the exact assertion to add; turning this on promotes it to a one-time hard block so a comment-only bound can't pass as a guarantee. The '§5 vertical' — encodes a research correctness discipline as a gate."
          },
          "sidecar.injectionGuard.enabled": {
            "type": "boolean",
            "default": true,
            "markdownDescription": "Prompt-injection guard. Scans tool output (file contents, web-search results, fetched URLs, shell/CI logs, tickets) for injection attempts — instruction overrides ('ignore previous instructions'), role hijacks ('you are now…'), fake system turns, permission manipulation, and secret-exfiltration lures — and FENCES any it finds in an explicit untrusted-data boundary before the content reaches the model, so external text is treated as data, not instructions. Non-blocking: it only wraps flagged content and surfaces a 🛡️ notice; clean output is untouched. On by default (small models are markedly more injection-susceptible). This is reasoning-layer defense, distinct from the secret/vulnerability scanners."
          },
          "sidecar.retrieval.cliffGate": {
            "type": "boolean",
            "default": true,
            "markdownDescription": "Trim workspace retrieval at its similarity cliff. Semantic search returns the top-k symbols by score; when those scores are tightly packed, the extra hits are near-identical siblings of the right answer rather than additional information, and they measurably hurt smaller models — injecting an undifferentiated top-6 took a local model from 90% to 55% on a one-line edit, while the same injection over clearly-distinct symbols cost nothing. With this on, hits below a sharp drop in score are dropped, and a result with no drop at all is reduced to its single best hit. Off restores the full top-k."
          },
          "sidecar.evalHistory.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the query_history agent tool. Allows the agent to run read-only SELECT queries against the local eval history database (.sidecar/history.db).",
            "requiresWindowReload": true
          },
          "sidecar.profiling.topN": {
            "type": "number",
            "default": 10,
            "minimum": 1,
            "maximum": 50,
            "description": "Number of hotspot entries to return from the profiler output. The profile_code tool's top_n parameter overrides this per-call."
          },
          "sidecar.latex.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the latex_compile agent tool. Compiles .tex files using latexmk or pdflatex and returns structured errors, warnings, and line references.",
            "requiresWindowReload": true
          },
          "sidecar.latex.compiler": {
            "type": "string",
            "default": "latexmk",
            "enum": [
              "latexmk",
              "pdflatex"
            ],
            "description": "LaTeX compiler to use. latexmk (default) handles bibliography and multi-pass compilation automatically; pdflatex is simpler but requires manual passes."
          },
          "sidecar.executiveFunction.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Checkpoint agent task state after each iteration so runs can resume after a VS Code restart or crash. Near-zero cost: one small JSON write per iteration. Disable if you never want a resume prompt on startup.",
            "requiresWindowReload": true
          },
          "sidecar.whatsNew.enabled": {
            "type": "boolean",
            "default": true,
            "description": "Show a one-time notification with release notes after SideCar updates to a new version. The 'SideCar: What's New' command always works regardless of this setting."
          },
          "sidecar.mcpDelegation.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Enable the delegate_to_mcp tool, which lets the SideCar agent delegate sub-tasks to agentic MCP servers.",
            "requiresWindowReload": true
          },
          "sidecar.mcpDelegation.allowedServers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Allowlist of MCP server names that delegate_to_mcp may target. Empty list allows all connected servers."
          },
          "sidecar.mcpServer.enabled": {
            "type": "boolean",
            "default": false,
            "description": "Expose SideCar's agent loop as a local MCP server so external agents can delegate tasks to it.",
            "requiresWindowReload": true
          },
          "sidecar.mcpServer.port": {
            "type": "number",
            "default": 3457,
            "minimum": 1024,
            "maximum": 65535,
            "description": "TCP port the SideCar MCP server listens on (127.0.0.1 only).",
            "requiresWindowReload": true
          },
          "sidecar.mcpServer.requireAuth": {
            "type": "boolean",
            "default": true,
            "description": "Require a bearer token for requests to the SideCar MCP server. When left on with no authToken set, SideCar auto-generates a token at startup and shows it to you. Turning this off exposes the agent loop to any local process.",
            "requiresWindowReload": true
          },
          "sidecar.mcpServer.authToken": {
            "type": "string",
            "default": "",
            "description": "Bearer token clients must supply when sidecar.mcpServer.requireAuth is true. Leave empty to have SideCar auto-generate one at startup.",
            "requiresWindowReload": true
          },
          "sidecar.mcpServer.maxConcurrent": {
            "type": "number",
            "default": 1,
            "minimum": 1,
            "maximum": 10,
            "description": "Maximum number of agent tasks the MCP server will run concurrently.",
            "requiresWindowReload": true
          },
          "sidecar.workspaceRoots": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Additional workspace root paths to include when the agent traverses files. Useful for monorepos where the opened folder is not the repo root."
          },
          "sidecar.maxFileSizeBytes": {
            "type": "number",
            "default": 102400,
            "minimum": 10240,
            "maximum": 10485760,
            "description": "Byte cap on file content pulled into WORKSPACE CONTEXT ranking (not the agent's read_file tool). Files over sidecar.streamingReadThreshold are summarized with a head+tail elision, bounded by this many bytes."
          },
          "sidecar.streamingReadThreshold": {
            "type": "number",
            "default": 51200,
            "minimum": 10240,
            "maximum": 10485760,
            "description": "File size (bytes) above which workspace-context ingestion switches to summary mode — a head+tail excerpt (bounded by sidecar.maxFileSizeBytes) instead of full content. Applies to context ranking, not the agent's read_file tool."
          },
          "sidecar.maxTraversalDepth": {
            "type": "number",
            "default": 10,
            "minimum": 1,
            "maximum": 20,
            "description": "Maximum directory depth the agent may traverse when listing files."
          },
          "sidecar.enableDocumentationRAG": {
            "type": "boolean",
            "default": true,
            "description": "Fetch and inject relevant documentation snippets into the agent context during retrieval. Disable to skip documentation RAG and reduce context noise in code-only workspaces."
          },
          "sidecar.ragMaxDocEntries": {
            "type": "number",
            "default": 20,
            "minimum": 1,
            "maximum": 100,
            "description": "Maximum number of documentation entries injected by the documentation RAG layer per agent turn."
          },
          "sidecar.enableAgentMemory": {
            "type": "boolean",
            "default": true,
            "description": "Enable the agent memory system — persistent per-workspace learning of patterns, conventions, and decisions across sessions."
          },
          "sidecar.agentMemoryMaxEntries": {
            "type": "number",
            "default": 500,
            "minimum": 10,
            "maximum": 2000,
            "description": "Maximum number of entries the agent memory store may hold. Oldest/least-used entries are evicted when the limit is reached."
          },
          "sidecar.enableSemanticSearch": {
            "type": "boolean",
            "default": true,
            "description": "Blend semantic (embedding-based) similarity into every workspace-index ranking pass, alongside keyword scoring (see sidecar.semanticSearchWeight for the mix). Not a fallback — it participates in every query when enabled.",
            "requiresWindowReload": true
          },
          "sidecar.semanticSearchWeight": {
            "type": "number",
            "default": 0.6,
            "minimum": 0,
            "maximum": 1,
            "description": "Weight of semantic search scores relative to keyword scores in the hybrid retrieval pipeline (0 = keyword only, 1 = semantic only)."
          }
        }
      }
    ],
    "viewsContainers": {
      "activitybar": [
        {
          "id": "sidecar-view-container",
          "title": "SideCar",
          "icon": "media/sidecar_silhouette.svg"
        }
      ]
    },
    "views": {
      "sidecar-view-container": [
        {
          "type": "webview",
          "id": "sidecar.chatView",
          "name": "Chat"
        },
        {
          "id": "sidecar.reviewPanel",
          "name": "Pending Agent Changes",
          "icon": "$(diff)",
          "when": "true"
        },
        {
          "id": "sidecar.pinnedMemory",
          "name": "Pinned Memory",
          "icon": "$(pin)",
          "when": "true"
        },
        {
          "id": "sidecar.rememberedInstructions",
          "name": "Remembered Instructions",
          "icon": "$(bookmark)",
          "when": "true"
        },
        {
          "id": "sidecar.editTimeline",
          "name": "Agent Edit History",
          "icon": "$(history)",
          "when": "true"
        },
        {
          "id": "sidecar.backgroundAgents",
          "name": "Background Agents",
          "icon": "$(play-circle)",
          "when": "true"
        },
        {
          "id": "sidecar.mcpServers",
          "name": "MCP Servers",
          "icon": "$(plug)",
          "when": "true"
        },
        {
          "id": "sidecar.sessions",
          "name": "Saved Sessions",
          "icon": "$(history)",
          "when": "true"
        },
        {
          "id": "sidecar.research",
          "name": "Research",
          "icon": "$(beaker)",
          "when": "config.sidecar.research.enabled"
        },
        {
          "id": "sidecar.pki",
          "name": "Project Knowledge Index",
          "icon": "$(database)",
          "when": "config.sidecar.projectKnowledge.enabled"
        },
        {
          "id": "sidecar.eval",
          "name": "Model Eval",
          "icon": "$(beaker)",
          "when": "true"
        }
      ]
    },
    "viewsWelcome": [
      {
        "view": "sidecar.reviewPanel",
        "contents": "No pending agent changes.\n\nWhen SideCar edits files, proposed changes appear here so you can review them before they're written to disk.\n\n[Accept All](command:sidecar.review.acceptAll)\n[Discard All](command:sidecar.review.discardAll)"
      },
      {
        "view": "sidecar.pinnedMemory",
        "contents": "No pinned memory entries.\n\nPin files, selections, or notes to inject them into every chat session.\n\n[Pin a file](command:sidecar.pinToMemory)\n[Pin active file](command:sidecar.pinActiveFileToMemory)"
      },
      {
        "view": "sidecar.editTimeline",
        "contents": "No agent edits yet.\n\nFiles the agent writes or edits during this chat session will appear here. You can revert individual files or all changes at once."
      },
      {
        "view": "sidecar.backgroundAgents",
        "contents": "No background agents running.\n\nBackground agents run tasks asynchronously while you keep working. Start one with `/bg <task>` in the chat."
      },
      {
        "view": "sidecar.mcpServers",
        "contents": "No MCP servers configured.\n\nMCP servers extend the agent with external tools. Add them in Settings under `sidecar.mcpServers`.\n\n[Open Settings](command:workbench.action.openSettings?%5B%22sidecar.mcpServers%22%5D)"
      },
      {
        "view": "sidecar.sessions",
        "contents": "No saved sessions.\n\nSave your current conversation to pick it back up later.\n\n[Save Current Session](command:sidecar.sessions.save)"
      },
      {
        "view": "sidecar.research",
        "contents": "No research projects yet.\n\nCreate a project to start tracking hypotheses, experiments, and observations.\n\n[New Project](command:sidecar.research.newProject)"
      },
      {
        "view": "sidecar.pki",
        "contents": "Project Knowledge Index is initialising…\n\nSymbols are being embedded in the background. The view will populate once indexing is underway."
      }
    ],
    "chatParticipants": [
      {
        "id": "sidecar.sidecar",
        "name": "sidecar",
        "description": "Ask SideCar — your local or cloud AI coding assistant — directly in Copilot Chat",
        "isSticky": true,
        "commands": [
          {
            "name": "review",
            "description": "Review the selected code or attached file for bugs and quality issues"
          },
          {
            "name": "fix",
            "description": "Fix issues in the selected code or attached file"
          },
          {
            "name": "explain",
            "description": "Explain what the selected code or attached file does"
          },
          {
            "name": "commit-message",
            "description": "Generate a conventional-commits message for the attached diff or staged changes"
          }
        ]
      }
    ],
    "languageModelTools": [
      {
        "name": "sidecar_read_file",
        "displayName": "Read File (SideCar)",
        "modelDescription": "Read the full contents of a file. Returns the file text. Use when you need to inspect source code, config, or any workspace file."
      },
      {
        "name": "sidecar_write_file",
        "displayName": "Write File (SideCar)",
        "modelDescription": "Create or fully overwrite a file with provided content. Use for new files or complete rewrites; prefer sidecar_edit_file for targeted changes."
      },
      {
        "name": "sidecar_edit_file",
        "displayName": "Edit File (SideCar)",
        "modelDescription": "Apply a targeted search-and-replace edit to an existing file. Provide the exact text to find (search) and the replacement text."
      },
      {
        "name": "sidecar_list_directory",
        "displayName": "List Directory (SideCar)",
        "modelDescription": "List files and directories at a given path. Returns names, types, and sizes. Use to explore workspace structure."
      },
      {
        "name": "sidecar_search_files",
        "displayName": "Search Files (SideCar)",
        "modelDescription": "Search across workspace files using a regex pattern and optional glob filter. Returns matching file paths and line excerpts."
      },
      {
        "name": "sidecar_run_command",
        "displayName": "Run Command (SideCar)",
        "modelDescription": "Execute a shell command in the workspace root and return its stdout/stderr. Use for build steps, formatting, or any shell operation."
      },
      {
        "name": "sidecar_run_tests",
        "displayName": "Run Tests (SideCar)",
        "modelDescription": "Run the project's test suite (or a specific test file/pattern) and return the results. Prefer this over run_command for test execution."
      },
      {
        "name": "sidecar_git_diff",
        "displayName": "Git Diff (SideCar)",
        "modelDescription": "Show unstaged changes, staged changes, or diff against a specific commit or branch. Use instead of running 'git diff' via shell."
      },
      {
        "name": "sidecar_git_status",
        "displayName": "Git Status (SideCar)",
        "modelDescription": "Show the current git working tree status: staged, unstaged, and untracked files."
      },
      {
        "name": "sidecar_git_log",
        "displayName": "Git Log (SideCar)",
        "modelDescription": "Show recent git commit history with author, date, and message. Optionally filter by file path or limit the number of commits."
      },
      {
        "name": "sidecar_web_search",
        "displayName": "Web Search (SideCar)",
        "modelDescription": "Search the web for up-to-date information. Returns ranked result snippets. Use for library docs, error messages, or anything not in the workspace."
      }
    ],
    "commands": [
      {
        "command": "sidecar.pinToMemory",
        "title": "Pin File to Memory",
        "category": "SideCar",
        "icon": "$(pin)"
      },
      {
        "command": "sidecar.pinActiveFileToMemory",
        "title": "Pin Active File to Memory",
        "category": "SideCar",
        "icon": "$(pin)"
      },
      {
        "command": "sidecar.pinSelectionToMemory",
        "title": "Pin Selection to Memory",
        "category": "SideCar",
        "icon": "$(pin)"
      },
      {
        "command": "sidecar.unpinMemory",
        "title": "Unpin Memory Entry",
        "category": "SideCar",
        "icon": "$(pinned-dirty)"
      },
      {
        "command": "sidecar.pinnedMemory.refresh",
        "title": "Refresh Pinned Memory from Disk",
        "category": "SideCar",
        "icon": "$(refresh)"
      },
      {
        "command": "sidecar.editTimeline.revert",
        "title": "Revert File to Pre-Agent State",
        "category": "SideCar",
        "icon": "$(discard)"
      },
      {
        "command": "sidecar.editTimeline.revertAll",
        "title": "Revert All Agent Edits",
        "category": "SideCar",
        "icon": "$(discard)"
      },
      {
        "command": "sidecar.editTimeline.clear",
        "title": "Clear Edit History",
        "category": "SideCar",
        "icon": "$(clear-all)"
      },
      {
        "command": "sidecar.bgAgents.cancelRun",
        "title": "Cancel Background Agent Run",
        "category": "SideCar",
        "icon": "$(debug-stop)"
      },
      {
        "command": "sidecar.bgAgents.clearCompleted",
        "title": "Clear Completed Runs",
        "category": "SideCar",
        "icon": "$(clear-all)"
      },
      {
        "command": "sidecar.mcp.reconnectServer",
        "title": "Reconnect MCP Server",
        "category": "SideCar",
        "icon": "$(refresh)"
      },
      {
        "command": "sidecar.mcp.reconnectAll",
        "title": "Reconnect All MCP Servers",
        "category": "SideCar",
        "icon": "$(refresh)"
      },
      {
        "command": "sidecar.sessions.save",
        "title": "Save Current Session",
        "category": "SideCar",
        "icon": "$(save)"
      },
      {
        "command": "sidecar.sessions.load",
        "title": "Load Session",
        "category": "SideCar"
      },
      {
        "command": "sidecar.sessions.rename",
        "title": "Rename Session",
        "category": "SideCar",
        "icon": "$(pencil)"
      },
      {
        "command": "sidecar.sessions.delete",
        "title": "Delete Session",
        "category": "SideCar",
        "icon": "$(trash)"
      },
      {
        "command": "sidecar.sessions.branch",
        "title": "Branch Session",
        "category": "SideCar",
        "icon": "$(git-branch)"
      },
      {
        "command": "sidecar.whatsNew",
        "title": "What's New",
        "category": "SideCar",
        "icon": "$(megaphone)"
      },
      {
        "command": "sidecar.bedrock.setRegion",
        "title": "Bedrock: Set Region",
        "category": "SideCar",
        "icon": "$(globe)"
      },
      {
        "command": "sidecar.executiveFunction.resume",
        "title": "Resume Interrupted Task",
        "category": "SideCar",
        "icon": "$(debug-continue)"
      },
      {
        "command": "sidecar.executiveFunction.discard",
        "title": "Discard Saved Task Checkpoint",
        "category": "SideCar",
        "icon": "$(trash)"
      },
      {
        "command": "sidecar.research.newProject",
        "title": "New Research Project",
        "category": "SideCar",
        "icon": "$(add)"
      },
      {
        "command": "sidecar.research.refresh",
        "title": "Refresh Research View",
        "category": "SideCar",
        "icon": "$(refresh)"
      },
      {
        "command": "sidecar.pki.rebuild",
        "title": "Rebuild Project Knowledge Index",
        "category": "SideCar",
        "icon": "$(refresh)"
      },
      {
        "command": "sidecar.pki.search",
        "title": "Search Project Knowledge Index",
        "category": "SideCar",
        "icon": "$(search)"
      },
      {
        "command": "sidecar.adaptivePaste.transform",
        "title": "Transform Paste with SideCar",
        "category": "SideCar",
        "icon": "$(wand)"
      },
      {
        "command": "sidecar.nextEdit.accept",
        "title": "Next Edit: Jump to First Suggestion",
        "category": "SideCar",
        "icon": "$(arrow-right)"
      },
      {
        "command": "sidecar.nextEdit.next",
        "title": "Next Edit: Go to Next Suggestion",
        "category": "SideCar"
      },
      {
        "command": "sidecar.nextEdit.previous",
        "title": "Next Edit: Go to Previous Suggestion",
        "category": "SideCar"
      },
      {
        "command": "sidecar.nextEdit.dismiss",
        "title": "Next Edit: Dismiss Suggestions",
        "category": "SideCar"
      },
      {
        "command": "sidecar.codelens.invoke",
        "title": "SideCar: Invoke CodeLens Action",
        "category": "SideCar"
      },
      {
        "command": "sidecar.toggleChat",
        "title": "Toggle Chat",
        "category": "SideCar",
        "icon": "$(comment-discussion)"
      },
      {
        "command": "sidecar.explainSelection",
        "title": "Explain Selection",
        "category": "SideCar",
        "icon": "$(info)"
      },
      {
        "command": "sidecar.fixSelection",
        "title": "Fix Selection",
        "category": "SideCar",
        "icon": "$(wrench)"
      },
      {
        "command": "sidecar.refactorSelection",
        "title": "Refactor Selection",
        "category": "SideCar",
        "icon": "$(symbol-class)"
      },
      {
        "command": "sidecar.inlineChat",
        "title": "Inline Chat",
        "category": "SideCar",
        "icon": "$(edit)"
      },
      {
        "command": "sidecar.reviewChanges",
        "title": "Review Changes",
        "category": "SideCar",
        "icon": "$(git-compare)"
      },
      {
        "command": "sidecar.summarizePR",
        "title": "Summarize Pull Request",
        "category": "SideCar",
        "icon": "$(git-pull-request)"
      },
      {
        "command": "sidecar.pr.create",
        "title": "Create Pull Request (Draft from Branch)",
        "category": "SideCar",
        "icon": "$(git-pull-request-create)"
      },
      {
        "command": "sidecar.ci.analyze",
        "title": "Analyze CI Failure",
        "category": "SideCar",
        "icon": "$(debug-alt)"
      },
      {
        "command": "sidecar.ci.fixFromDiagnostic",
        "title": "Fix CI Failure from Diagnostic",
        "category": "SideCar",
        "icon": "$(wrench)"
      },
      {
        "command": "sidecar.pr.postReview",
        "title": "Post PR Review with Inline Comments (Agent)",
        "category": "SideCar",
        "icon": "$(eye)"
      },
      {
        "command": "sidecar.pr.reviewComments",
        "title": "Review PR Comments",
        "category": "SideCar",
        "icon": "$(comment-discussion)"
      },
      {
        "command": "sidecar.pr.respond",
        "title": "Respond to PR Comments (Agent)",
        "category": "SideCar",
        "icon": "$(hubot)"
      },
      {
        "command": "sidecar.pr.markReady",
        "title": "Mark PR Ready for Review",
        "category": "SideCar",
        "icon": "$(pass)"
      },
      {
        "command": "sidecar.pr.checkCi",
        "title": "Check PR CI Status",
        "category": "SideCar",
        "icon": "$(pulse)"
      },
      {
        "command": "sidecar.generateCommitMessage",
        "title": "Generate Commit Message",
        "category": "SideCar",
        "icon": "$(git-commit)"
      },
      {
        "command": "sidecar.scm.suggestCommitMessage",
        "title": "Suggest Commit Message (SCM Input)",
        "category": "SideCar",
        "icon": "$(git-commit)"
      },
      {
        "command": "sidecar.generateSidecarMd",
        "title": "Generate SIDECAR.md",
        "category": "SideCar",
        "icon": "$(file-text)"
      },
      {
        "command": "sidecar.scanStaged",
        "title": "Scan Staged Files for Secrets",
        "category": "SideCar",
        "icon": "$(shield)"
      },
      {
        "command": "sidecar.discoverModels",
        "title": "Discover Available Models",
        "category": "SideCar",
        "icon": "$(search)"
      },
      {
        "command": "sidecar.selectModel",
        "title": "Select Model",
        "category": "SideCar",
        "icon": "$(symbol-enum)"
      },
      {
        "command": "sidecar.clearChat",
        "title": "Clear Chat",
        "category": "SideCar",
        "icon": "$(clear-all)"
      },
      {
        "command": "sidecar.undoChanges",
        "title": "Undo All Changes",
        "category": "SideCar",
        "icon": "$(discard)"
      },
      {
        "command": "sidecar.exportChat",
        "title": "Export Chat",
        "category": "SideCar",
        "icon": "$(export)"
      },
      {
        "command": "sidecar.syncSkillRegistries",
        "title": "Sync Skill Registries",
        "category": "SideCar",
        "icon": "$(sync)"
      },
      {
        "command": "sidecar.skills.openMarketplace",
        "title": "Browse Skill Marketplace",
        "category": "SideCar",
        "icon": "$(extensions)"
      },
      {
        "command": "sidecar.skills.pick",
        "title": "Pick Skill",
        "category": "SideCar",
        "icon": "$(list-selection)"
      },
      {
        "command": "sidecar.skills.sync",
        "title": "Sync Skill Registries",
        "category": "SideCar",
        "icon": "$(sync)"
      },
      {
        "command": "sidecar.skills.publish",
        "title": "Publish Skill to Registry",
        "category": "SideCar",
        "icon": "$(cloud-upload)"
      },
      {
        "command": "sidecar.mcp.openMarketplace",
        "title": "Browse MCP Server Marketplace",
        "category": "SideCar",
        "icon": "$(extensions)"
      },
      {
        "command": "sidecar.setApiKey",
        "title": "Set / Refresh API Key",
        "category": "SideCar",
        "icon": "$(key)"
      },
      {
        "command": "sidecar.setHuggingFaceToken",
        "title": "Set / Clear HuggingFace Token",
        "category": "SideCar",
        "icon": "$(key)"
      },
      {
        "command": "sidecar.showSpend",
        "title": "Show Session Spend",
        "category": "SideCar",
        "icon": "$(credit-card)"
      },
      {
        "command": "sidecar.resetSpend",
        "title": "Reset Session Spend",
        "category": "SideCar",
        "icon": "$(trash)"
      },
      {
        "command": "sidecar.clearDiagnostics",
        "title": "Clear Diagnostics",
        "category": "SideCar",
        "icon": "$(clear-all)"
      },
      {
        "command": "sidecar.handoff.export",
        "title": "Export Handoff",
        "category": "SideCar",
        "icon": "$(export)"
      },
      {
        "command": "sidecar.handoff.import",
        "title": "Import Handoff",
        "category": "SideCar",
        "icon": "$(import)"
      },
      {
        "command": "sidecar.audit.review",
        "title": "Audit: Review Buffered Changes",
        "category": "SideCar",
        "icon": "$(list-unordered)"
      },
      {
        "command": "sidecar.audit.acceptAll",
        "title": "Audit: Accept All Buffered Changes",
        "category": "SideCar",
        "icon": "$(check-all)"
      },
      {
        "command": "sidecar.audit.rejectAll",
        "title": "Audit: Reject All Buffered Changes",
        "category": "SideCar",
        "icon": "$(discard)"
      },
      {
        "command": "sidecar.shadows.sweepStale",
        "title": "Shadow Workspaces: Sweep Stale Worktrees",
        "category": "SideCar",
        "icon": "$(trash)"
      },
      {
        "command": "sidecar.facets.dispatch",
        "title": "Facets: Dispatch Specialists",
        "category": "SideCar",
        "icon": "$(organization)"
      },
      {
        "command": "sidecar.startAutoMode",
        "title": "Start Auto Mode",
        "category": "SideCar",
        "icon": "$(play)"
      },
      {
        "command": "sidecar.stopAutoMode",
        "title": "Stop Auto Mode",
        "category": "SideCar",
        "icon": "$(stop)"
      },
      {
        "command": "sidecar.scheduler.run",
        "title": "Run Scheduled Task Now",
        "category": "SideCar",
        "icon": "$(run)"
      },
      {
        "command": "sidecar.fork.dispatch",
        "title": "Fork & Compare",
        "category": "SideCar",
        "icon": "$(repo-forked)"
      },
      {
        "command": "sidecar.arena.open",
        "title": "Open Model Arena (Chat)",
        "category": "SideCar",
        "icon": "$(beaker)"
      },
      {
        "command": "sidecar.arena.agent",
        "title": "Open Model Arena (Agent Task)",
        "category": "SideCar",
        "icon": "$(beaker)"
      },
      {
        "command": "sidecar.deps.scan",
        "title": "Scan Dependencies for Drift & Vulnerabilities",
        "category": "SideCar",
        "icon": "$(shield)"
      },
      {
        "command": "sidecar.testCurrentModel",
        "title": "Test Current Model (Smoke Eval)",
        "category": "SideCar",
        "icon": "$(beaker)"
      },
      {
        "command": "sidecar.eval.openReport",
        "title": "Open Eval Failure Report",
        "category": "SideCar",
        "icon": "$(open-preview)"
      },
      {
        "command": "sidecar.memory.refresh",
        "title": "Refresh Memory Stats",
        "category": "SideCar",
        "icon": "$(dashboard)"
      },
      {
        "command": "sidecar.noSql.install",
        "title": "Install NoSQL MCP Server (MongoDB / Redis)",
        "category": "SideCar",
        "icon": "$(database)"
      },
      {
        "command": "sidecar.resolveConflicts",
        "title": "Resolve Merge Conflicts",
        "category": "SideCar",
        "icon": "$(git-merge)"
      },
      {
        "command": "sidecar.kickstand.loadModel",
        "title": "Kickstand: Load Model",
        "category": "SideCar",
        "icon": "$(cloud-upload)"
      },
      {
        "command": "sidecar.kickstand.unloadModel",
        "title": "Kickstand: Unload Model",
        "category": "SideCar",
        "icon": "$(cloud-download)"
      },
      {
        "command": "sidecar.kickstand.loadAdapter",
        "title": "Kickstand: Load LoRA Adapter",
        "category": "SideCar",
        "icon": "$(layers)"
      },
      {
        "command": "sidecar.kickstand.unloadAdapter",
        "title": "Kickstand: Unload LoRA Adapter",
        "category": "SideCar",
        "icon": "$(close)"
      },
      {
        "command": "sidecar.modelBrowser",
        "title": "Browse & Pull Models (HuggingFace)",
        "category": "SideCar",
        "icon": "$(search)"
      },
      {
        "command": "sidecar.openWalkthrough",
        "title": "Open Walkthrough",
        "category": "SideCar",
        "icon": "$(rocket)"
      },
      {
        "command": "sidecar.switchBackend",
        "title": "Switch Backend",
        "category": "SideCar",
        "icon": "$(arrow-swap)"
      },
      {
        "command": "sidecar.acceptInlineEdit",
        "title": "Accept Inline Edit",
        "category": "SideCar",
        "icon": "$(check)"
      },
      {
        "command": "sidecar.rejectInlineEdit",
        "title": "Dismiss Inline Edit",
        "category": "SideCar",
        "icon": "$(close)"
      },
      {
        "command": "sidecar.review.acceptFile",
        "title": "Accept Pending Change",
        "category": "SideCar",
        "icon": "$(check)"
      },
      {
        "command": "sidecar.review.discardFile",
        "title": "Discard Pending Change",
        "category": "SideCar",
        "icon": "$(close)"
      },
      {
        "command": "sidecar.review.acceptAll",
        "title": "Accept All Pending Changes",
        "category": "SideCar",
        "icon": "$(check-all)"
      },
      {
        "command": "sidecar.review.discardAll",
        "title": "Discard All Pending Changes",
        "category": "SideCar",
        "icon": "$(trash)"
      },
      {
        "command": "sidecar.review.openDiff",
        "title": "Show Pending Diff",
        "category": "SideCar",
        "icon": "$(diff)"
      },
      {
        "command": "sidecar.memory.forgetInstruction",
        "title": "SideCar: Forget Remembered Instruction",
        "icon": "$(trash)"
      },
      {
        "command": "sidecar.memory.clearInstructions",
        "title": "SideCar: Forget All Remembered Instructions",
        "icon": "$(clear-all)"
      },
      {
        "command": "sidecar.memory.refreshInstructions",
        "title": "SideCar: Refresh Remembered Instructions",
        "icon": "$(refresh)"
      }
    ],
    "keybindings": [
      {
        "command": "sidecar.toggleChat",
        "key": "ctrl+shift+i",
        "mac": "cmd+shift+i"
      },
      {
        "command": "sidecar.inlineChat",
        "key": "ctrl+i",
        "mac": "cmd+i",
        "when": "editorTextFocus"
      },
      {
        "command": "sidecar.clearChat",
        "key": "ctrl+l",
        "mac": "cmd+l"
      },
      {
        "command": "sidecar.undoChanges",
        "key": "ctrl+shift+u",
        "mac": "cmd+shift+u"
      },
      {
        "command": "sidecar.exportChat",
        "key": "ctrl+shift+e",
        "mac": "cmd+shift+e"
      },
      {
        "command": "sidecar.rejectInlineEdit",
        "key": "escape",
        "when": "editorTextFocus && sidecar.hasInlineEdit"
      },
      {
        "command": "editor.action.inlineSuggest.acceptNextWord",
        "key": "ctrl+right",
        "mac": "cmd+right",
        "when": "inlineSuggestionVisible && !editorReadonly"
      },
      {
        "command": "sidecar.sessions.rename",
        "key": "f2",
        "when": "focusedView == sidecar.sessions && listHasSelectionOrFocus"
      },
      {
        "command": "sidecar.sessions.load",
        "key": "enter",
        "when": "focusedView == sidecar.sessions && listHasSelectionOrFocus"
      }
    ],
    "menus": {
      "commandPalette": [
        {
          "command": "sidecar.ci.fixFromDiagnostic",
          "when": "false"
        },
        {
          "command": "sidecar.acceptInlineEdit",
          "when": "sidecar.hasInlineEdit"
        },
        {
          "command": "sidecar.rejectInlineEdit",
          "when": "sidecar.hasInlineEdit"
        },
        {
          "command": "sidecar.review.acceptFile",
          "when": "false"
        },
        {
          "command": "sidecar.review.discardFile",
          "when": "false"
        },
        {
          "command": "sidecar.review.openDiff",
          "when": "false"
        },
        {
          "command": "sidecar.explainSelection",
          "when": "editorHasSelection"
        },
        {
          "command": "sidecar.fixSelection",
          "when": "editorHasSelection"
        },
        {
          "command": "sidecar.refactorSelection",
          "when": "editorHasSelection"
        }
      ],
      "scm/title": [
        {
          "command": "sidecar.scm.suggestCommitMessage",
          "when": "scmProvider == git",
          "group": "navigation"
        }
      ],
      "editor/context": [
        {
          "command": "sidecar.explainSelection",
          "when": "editorHasSelection",
          "group": "sidecar@1"
        },
        {
          "command": "sidecar.fixSelection",
          "when": "editorHasSelection",
          "group": "sidecar@2"
        },
        {
          "command": "sidecar.refactorSelection",
          "when": "editorHasSelection",
          "group": "sidecar@3"
        }
      ],
      "view/title": [
        {
          "command": "sidecar.review.acceptAll",
          "when": "view == sidecar.reviewPanel",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.review.discardAll",
          "when": "view == sidecar.reviewPanel",
          "group": "navigation@2"
        },
        {
          "command": "sidecar.pinActiveFileToMemory",
          "when": "view == sidecar.pinnedMemory",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.pinToMemory",
          "when": "view == sidecar.pinnedMemory",
          "group": "navigation@2"
        },
        {
          "command": "sidecar.pinnedMemory.refresh",
          "when": "view == sidecar.pinnedMemory",
          "group": "navigation@3"
        },
        {
          "command": "sidecar.setApiKey",
          "when": "view == sidecar.chatView",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.showSpend",
          "when": "view == sidecar.chatView",
          "group": "1_config@2"
        },
        {
          "command": "sidecar.editTimeline.revertAll",
          "when": "view == sidecar.editTimeline",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.editTimeline.clear",
          "when": "view == sidecar.editTimeline",
          "group": "navigation@2"
        },
        {
          "command": "sidecar.bgAgents.clearCompleted",
          "when": "view == sidecar.backgroundAgents",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.mcp.reconnectAll",
          "when": "view == sidecar.mcpServers",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.sessions.save",
          "when": "view == sidecar.sessions",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.research.newProject",
          "when": "view == sidecar.research",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.research.refresh",
          "when": "view == sidecar.research",
          "group": "navigation@2"
        },
        {
          "command": "sidecar.pki.rebuild",
          "when": "view == sidecar.pki",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.pki.search",
          "when": "view == sidecar.pki",
          "group": "navigation@2"
        },
        {
          "command": "sidecar.eval.openReport",
          "when": "view == sidecar.eval",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.memory.refreshInstructions",
          "when": "view == sidecar.rememberedInstructions",
          "group": "navigation@1"
        },
        {
          "command": "sidecar.memory.clearInstructions",
          "when": "view == sidecar.rememberedInstructions",
          "group": "navigation@2"
        }
      ],
      "view/item/context": [
        {
          "command": "sidecar.review.acceptFile",
          "when": "view == sidecar.reviewPanel && viewItem == sidecar.reviewEntry",
          "group": "inline@1"
        },
        {
          "command": "sidecar.review.discardFile",
          "when": "view == sidecar.reviewPanel && viewItem == sidecar.reviewEntry",
          "group": "inline@2"
        },
        {
          "command": "sidecar.unpinMemory",
          "when": "view == sidecar.pinnedMemory && viewItem == pinnedEntry",
          "group": "inline@1"
        },
        {
          "command": "sidecar.editTimeline.revert",
          "when": "view == sidecar.editTimeline && viewItem == timelineFile",
          "group": "inline@1"
        },
        {
          "command": "sidecar.bgAgents.cancelRun",
          "when": "view == sidecar.backgroundAgents && viewItem == bgRunActive",
          "group": "inline@1"
        },
        {
          "command": "sidecar.mcp.reconnectServer",
          "when": "view == sidecar.mcpServers && viewItem == mcpServerFailed",
          "group": "inline@1"
        },
        {
          "command": "sidecar.sessions.branch",
          "when": "view == sidecar.sessions && viewItem == sessionEntry",
          "group": "inline@3"
        },
        {
          "command": "sidecar.sessions.rename",
          "when": "view == sidecar.sessions && viewItem == sessionEntry",
          "group": "inline@2"
        },
        {
          "command": "sidecar.sessions.delete",
          "when": "view == sidecar.sessions && viewItem == sessionEntry",
          "group": "inline@1"
        },
        {
          "command": "sidecar.memory.forgetInstruction",
          "when": "view == sidecar.rememberedInstructions && viewItem == rememberedInstruction",
          "group": "inline@1"
        }
      ]
    },
    "walkthroughs": [
      {
        "id": "sidecar.gettingStarted",
        "title": "Get Started with SideCar",
        "description": "Local-first AI coding assistant — chat, inline edits, code actions, and native Problems integration.",
        "steps": [
          {
            "id": "sidecar.walkthrough.welcome",
            "title": "Welcome",
            "description": "What SideCar is and what ships in the box.",
            "media": {
              "markdown": "media/walkthroughs/01-welcome.md"
            },
            "completionEvents": [
              "onView:sidecar.chatView"
            ]
          },
          {
            "id": "sidecar.walkthrough.backend",
            "title": "Pick a backend",
            "description": "Run locally with Ollama, or plug in an Anthropic / OpenAI key. Keys are stored in SecretStorage.",
            "media": {
              "markdown": "media/walkthroughs/02-backend.md"
            },
            "completionEvents": [
              "onCommand:sidecar.switchBackend",
              "onCommand:sidecar.setApiKey"
            ]
          },
          {
            "id": "sidecar.walkthrough.chat",
            "title": "Open the chat",
            "description": "Toggle the SideCar chat sidebar and send your first message.",
            "media": {
              "markdown": "media/walkthroughs/03-chat.md"
            },
            "completionEvents": [
              "onCommand:sidecar.toggleChat",
              "onView:sidecar.chatView"
            ]
          },
          {
            "id": "sidecar.walkthrough.inline",
            "title": "Inline editing and the lightbulb",
            "description": "Inline chat with ⌘I, and Fix / Explain / Refactor from the code actions menu.",
            "media": {
              "markdown": "media/walkthroughs/04-inline.md"
            },
            "completionEvents": [
              "onCommand:sidecar.inlineChat",
              "onCommand:sidecar.fixSelection",
              "onCommand:sidecar.explainSelection"
            ]
          },
          {
            "id": "sidecar.walkthrough.discover",
            "title": "Discover every action",
            "description": "Browse the Command Palette, Problems panel integration, and pending-change review.",
            "media": {
              "markdown": "media/walkthroughs/05-discover.md"
            },
            "completionEvents": [
              "onCommand:sidecar.showSpend",
              "onCommand:sidecar.reviewChanges"
            ]
          }
        ]
      }
    ]
  },
  "scripts": {
    "compile": "tsc -p ./",
    "bundle": "esbuild ./src/extension.ts --bundle --outfile=dist/extension.js --external:vscode --external:web-tree-sitter --external:@huggingface/transformers --external:better-sqlite3 --external:@duckdb/node-api --external:playwright-core --external:@lancedb/lancedb --external:esbuild --format=cjs --platform=node --sourcemap --minify --tree-shaking=true",
    "watch": "esbuild ./src/extension.ts --bundle --outfile=dist/extension.js --external:vscode --external:web-tree-sitter --external:@huggingface/transformers --external:better-sqlite3 --external:@duckdb/node-api --external:playwright-core --external:@lancedb/lancedb --external:esbuild --format=cjs --platform=node --sourcemap --watch",
    "copy-grammars": "node scripts/copy-grammars.mjs",
    "build": "npm run compile && npm run bundle && npm run copy-grammars",
    "package": "npm run build && npx @vscode/vsce package",
    "verify:package": "node scripts/verify-package.mjs",
    "verify:release": "node scripts/verify-release.mjs",
    "test": "vitest run",
    "test:watch": "vitest",
    "test:coverage": "vitest run --coverage",
    "test:integration": "node scripts/integration-clean.mjs pre && npm run compile && npm run bundle && tsc -p src/test/integration/tsconfig.json && node scripts/integration-clean.mjs post && vscode-test",
    "eval:llm": "vitest run --config vitest.eval.config.ts",
    "eval:smoke": "cross-env SIDECAR_EVAL_TAGS=smoke vitest run --config vitest.eval.config.ts tests/llm-eval/agent.eval.ts",
    "eval:agent": "vitest run --config vitest.eval.config.ts tests/llm-eval/agent.eval.ts",
    "eval:agent:baseline": "cross-env SIDECAR_AGENT_SEED=42 vitest run --config vitest.eval.config.ts tests/llm-eval/agentBaseline.eval.ts",
    "eval:agent:baseline:record": "cross-env SIDECAR_RECORD_AGENT_BASELINE=1 SIDECAR_AGENT_SEED=42 vitest run --config vitest.eval.config.ts tests/llm-eval/agentBaseline.eval.ts",
    "eval:ablation": "vitest run --config vitest.eval.config.ts tests/llm-eval/ablation.eval.ts",
    "eval:prompt": "vitest run --config vitest.eval.config.ts tests/llm-eval/prompt.eval.ts",
    "eval:case": "vitest run --config vitest.eval.config.ts tests/llm-eval/agent.eval.ts tests/llm-eval/prompt.eval.ts",
    "eval:parity": "vitest run --config vitest.eval.config.ts tests/llm-eval/embeddingParity.eval.ts",
    "eval:parity:record": "cross-env SIDECAR_RECORD_PARITY_BASELINE=1 vitest run --config vitest.eval.config.ts tests/llm-eval/embeddingParity.eval.ts",
    "eval:compare": "vitest run --config vitest.eval.config.ts tests/llm-eval/modelComparison.eval.ts",
    "eval:guardprobe": "cross-env SIDECAR_EVAL_TRAJECTORY_DIR=.sidecar/logs/eval-trajectories vitest run --config vitest.eval.config.ts tests/llm-eval/guardProbe.eval.ts",
    "eval:reliability": "cross-env SIDECAR_EVAL_TAGS=smoke SIDECAR_EVAL_TRIALS=3 vitest run --config vitest.eval.config.ts tests/llm-eval/agent.eval.ts",
    "bench:bfcl": "vitest run --config vitest.eval.config.ts bench/bfcl/run.eval.ts",
    "bench:swe:predict": "vitest run --config vitest.eval.config.ts tests/llm-eval/swe.eval.ts",
    "bench:swe:ablate": "vitest run --config vitest.eval.config.ts bench/swe/ablate.eval.ts",
    "bench:swe:local": "bash bench/swe/local/run_local.sh",
    "compile:bench": "tsc -p tsconfig.bench.json",
    "lint": "eslint src/ media/",
    "format": "prettier --write \"src/**/*.ts\"",
    "format:check": "prettier --check \"src/**/*.ts\"",
    "check": "npm run compile && npm run compile:bench && npm run compile:tests && npm run lint && npm run format:check && npm run test",
    "bump": "bash scripts/bump-version.sh",
    "prepare": "husky",
    "compile:tests": "tsc -p tsconfig.tests.json",
    "deadcode": "knip --no-progress",
    "deadcode:fix": "knip --fix --no-progress",
    "promptlab": "npx --yes tsx bench/promptlab/cli.ts"
  },
  "devDependencies": {
    "@duckdb/node-api": "^1.5.2-r.1",
    "@stryker-mutator/core": "^9.6.1",
    "@stryker-mutator/vitest-runner": "^9.6.1",
    "@types/better-sqlite3": "^7.6.13",
    "@types/mocha": "^10.0.10",
    "@types/node": "^20.0.0",
    "@types/pdf-parse": "^1.1.5",
    "@types/pg": "^8.20.0",
    "@types/vscode": "^1.116.0",
    "@typescript-eslint/eslint-plugin": "^8.59.0",
    "@typescript-eslint/parser": "^8.59.0",
    "@vitest/coverage-v8": "^4.1.10",
    "@vscode/test-cli": "^0.0.15",
    "@vscode/test-electron": "^3.1.0",
    "@vscode/vsce": "^3.9.1",
    "better-sqlite3": "^12.9.0",
    "cross-env": "^10.1.0",
    "esbuild": "^0.28.0",
    "eslint": "^10.2.1",
    "eslint-config-prettier": "^10.1.8",
    "fast-check": "^4.9.0",
    "happy-dom": "^20.10.5",
    "husky": "^9.1.7",
    "knip": "^6.32.2",
    "lint-staged": "^16.4.0",
    "mysql2": "^3.22.2",
    "pg": "^8.20.0",
    "playwright-core": "^1.59.1",
    "prettier": "^3.8.3",
    "tree-sitter-wasms": "^0.1.13",
    "typescript": "^5.3.0",
    "vitest": "^4.1.10"
  },
  "dependencies": {
    "@huggingface/transformers": "^4.1.0",
    "@modelcontextprotocol/sdk": "^1.29.0",
    "mermaid": "^11.14.0",
    "pdf-parse": "^2.4.5",
    "web-tree-sitter": "^0.24.7"
  },
  "optionalDependencies": {
    "@lancedb/lancedb": "^0.27.2"
  },
  "overrides": {
    "uuid": ">=14.0.0",
    "diff": ">=9.0.0",
    "serialize-javascript": ">=7.0.5"
  },
  "lint-staged": {
    "src/**/*.ts": [
      "prettier --write",
      "eslint --max-warnings=0 --no-warn-ignored",
      "bash -c 'tsc --noEmit'",
      "bash -c 'vitest run --silent --exclude \"**/shadowWorkspace.test.ts\" --exclude \"**/shadowSweep.test.ts\"'"
    ],
    "tests/**/*.ts": [
      "prettier --write",
      "eslint --max-warnings=0 --no-warn-ignored",
      "bash -c 'tsc -p tsconfig.tests.json'",
      "bash -c 'vitest run --silent --exclude \"**/shadowWorkspace.test.ts\" --exclude \"**/shadowSweep.test.ts\"'"
    ],
    "bench/**/*.ts": [
      "prettier --write",
      "eslint --max-warnings=0 --no-warn-ignored",
      "bash -c 'tsc -p tsconfig.bench.json'",
      "bash -c 'vitest run bench/ --silent'"
    ],
    "media/**/*.css": [
      "prettier --write"
    ],
    "media/**/*.js": [
      "prettier --write",
      "eslint --max-warnings=0"
    ],
    "**/*.{md,json}": [
      "prettier --write"
    ]
  }
}