@j0hanz/code-assistant 0.9.0

package/README.md

@@ -0,0 +1,437 @@
+# Code Assistant MCP Server
+
+<!-- mcp-name: io.github.j0hanz/code-assistant -->
+
+[![npm](https://img.shields.io/npm/v/%40j0hanz%2Fcode-assistant-mcp?style=flat-square&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@j0hanz/code-assistant-mcp) [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D24-339933?style=flat-square&logo=nodedotjs&logoColor=white)](package.json) [![TypeScript](https://img.shields.io/badge/TypeScript-5.9%2B-3178C6?style=flat-square&logo=typescript&logoColor=white)](package.json) [![MCP SDK](https://img.shields.io/badge/MCP_SDK-1.26%2B-6f42c1?style=flat-square)](package.json) [![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](package.json)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Code+Assistant&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcode-assistant-mcp%40latest%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Code+Assistant&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcode-assistant-mcp%40latest%22%5D%7D&quality=insiders) [![Install in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install_Server-C16FDE?logo=visualstudio&logoColor=white)](https://vs-open.link/mcp-install?%7B%22name%22%3A%22code-assistant%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcode-assistant-mcp%40latest%22%5D%7D)
+
+[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=code-assistant&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqMGhhbnovY29kZS1hc3Npc3RhbnQtbWNwQGxhdGVzdCJdfQ==)
+
+Gemini-powered MCP server for code analysis with structured outputs for findings, risk assessment, and focused patch suggestions.
+
+## Overview
+
+This server accepts unified diffs and returns structured JSON results — findings with severity, impact categories, merge risk, test plans, and verbatim search/replace fixes. It uses Gemini Thinking models (Flash for fast tools, Flash for deep analysis) and runs over **stdio transport**.
+
+## Key Features
+
+- **Impact Analysis** — Objective severity scoring, breaking change detection, and rollback complexity assessment.
+- **Review Summary** — Concise PR digest with merge recommendation and change statistics.
+- **Deep Code Inspection** — Flash model with high thinking level for context-aware analysis using full file contents.
+- **Search & Replace Fixes** — Verbatim, copy-paste-ready code fixes tied to specific findings.
+- **Test Plan Generation** — Systematic test case generation with priority ranking and pseudocode.
+- **Async Task Support** — All tools support MCP task lifecycle with progress notifications.
+
+## Requirements
+
+- Node.js `>=24`
+- One API key: `GEMINI_API_KEY` or `GOOGLE_API_KEY`
+- MCP client that supports stdio servers and tool calls
+
+## Quick Start
+
+```json
+{
+  "mcpServers": {
+    "code-assistant": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+      "env": {
+        "GEMINI_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## Client Configuration
+
+<details>
+<summary><b>VS Code / VS Code Insiders</b></summary>
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Code+Assistant&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcode-assistant-mcp%40latest%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Code+Assistant&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcode-assistant-mcp%40latest%22%5D%7D&quality=insiders)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "code-assistant": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+      "env": {
+        "GEMINI_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Or via CLI:
+
+```bash
+code --add-mcp '{"name":"code-assistant","command":"npx","args":["-y","@j0hanz/code-assistant-mcp@latest"]}'
+```
+
+</details>
+
+<details>
+<summary><b>Cursor</b></summary>
+
+[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=code-assistant&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqMGhhbnovY29kZS1hc3Npc3RhbnQtbWNwQGxhdGVzdCJdfQ==)
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "code-assistant": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+      "env": {
+        "GEMINI_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Visual Studio</b></summary>
+
+[![Install in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install_Server-C16FDE?logo=visualstudio&logoColor=white)](https://vs-open.link/mcp-install?%7B%22name%22%3A%22code-assistant%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcode-assistant-mcp%40latest%22%5D%7D)
+
+For more info, see [Visual Studio MCP docs](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers).
+
+</details>
+
+<details>
+<summary><b>Claude Desktop</b></summary>
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "code-assistant": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+      "env": {
+        "GEMINI_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+For more info, see [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user).
+
+</details>
+
+<details>
+<summary><b>Claude Code</b></summary>
+
+```bash
+claude mcp add code-assistant -- npx -y @j0hanz/code-assistant-mcp@latest
+```
+
+For more info, see [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp).
+
+</details>
+
+<details>
+<summary><b>Windsurf</b></summary>
+
+Add to MCP config:
+
+```json
+{
+  "mcpServers": {
+    "code-assistant": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+      "env": {
+        "GEMINI_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+For more info, see [Windsurf MCP docs](https://docs.windsurf.com/windsurf/mcp).
+
+</details>
+
+<details>
+<summary><b>Amp</b></summary>
+
+```bash
+amp mcp add code-assistant -- npx -y @j0hanz/code-assistant-mcp@latest
+```
+
+For more info, see [Amp MCP docs](https://docs.amp.dev/mcp).
+
+</details>
+
+<details>
+<summary><b>Cline</b></summary>
+
+Add to `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "code-assistant": {
+      "command": "npx",
+      "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+      "env": {
+        "GEMINI_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+For more info, see [Cline MCP docs](https://docs.cline.bot/mcp-servers/configuring-mcp-servers).
+
+</details>
+
+<details>
+<summary><b>Zed</b></summary>
+
+Add to Zed `settings.json`:
+
+```json
+{
+  "context_servers": {
+    "code-assistant": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+        "env": {
+          "GEMINI_API_KEY": "YOUR_API_KEY"
+        }
+      }
+    }
+  }
+}
+```
+
+For more info, see [Zed MCP docs](https://zed.dev/docs/assistant/model-context-protocol).
+
+</details>
+
+<details>
+<summary><b>Augment</b></summary>
+
+Add to `settings.json`:
+
+```json
+{
+  "augment.advanced": {
+    "mcpServers": [
+      {
+        "name": "code-assistant",
+        "command": "npx",
+        "args": ["-y", "@j0hanz/code-assistant-mcp@latest"],
+        "env": {
+          "GEMINI_API_KEY": "YOUR_API_KEY"
+        }
+      }
+    ]
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Docker</b></summary>
+
+```json
+{
+  "mcpServers": {
+    "code-assistant": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "GEMINI_API_KEY=YOUR_API_KEY",
+        "ghcr.io/j0hanz/code-assistant-mcp:latest"
+      ]
+    }
+  }
+}
+```
+
+Or build locally:
+
+```bash
+docker build -t code-assistant-mcp .
+```
+
+</details>
+
+## Tools
+
+> [!IMPORTANT]
+> Call `generate_diff` first (`mode: "unstaged"` or `"staged"`). All review tools read the cached server-side diff (`diff://current`) and do not accept a direct `diff` parameter.
+
+### `generate_diff`
+
+Generate and cache the current branch diff for downstream review tools.
+
+| Parameter | Type     | Required | Description                                        |
+| --------- | -------- | -------- | -------------------------------------------------- |
+| `mode`    | `string` | Yes      | `unstaged` (working tree) or `staged` (git index). |
+
+**Returns:** `diffRef`, `stats` (files, added, deleted), `generatedAt`, `mode`, `message`.
+
+### `analyze_pr_impact`
+
+Assess the impact and risk of cached pull request changes using the Flash model.
+
+| Parameter    | Type     | Required | Description                              |
+| ------------ | -------- | -------- | ---------------------------------------- |
+| `repository` | `string` | Yes      | Repository identifier (e.g. `org/repo`). |
+| `language`   | `string` | No       | Primary language hint.                   |
+
+**Returns:** `severity` (low/medium/high/critical), `categories[]`, `breakingChanges[]`, `affectedAreas[]`, `rollbackComplexity`, `summary`.
+
+### `generate_review_summary`
+
+Summarize a pull request diff and assess high-level risk using the Flash model.
+
+| Parameter    | Type     | Required | Description                              |
+| ------------ | -------- | -------- | ---------------------------------------- |
+| `repository` | `string` | Yes      | Repository identifier (e.g. `org/repo`). |
+| `language`   | `string` | No       | Primary language hint.                   |
+
+**Returns:** `summary`, `overallRisk` (low/medium/high), `keyChanges[]`, `recommendation`, `stats` (filesChanged, linesAdded, linesRemoved).
+
+### `generate_test_plan`
+
+Create a test plan covering the changes in the diff using the Flash model with thinking (8K token budget).
+
+| Parameter       | Type     | Required | Description                                 |
+| --------------- | -------- | -------- | ------------------------------------------- |
+| `repository`    | `string` | Yes      | Repository identifier (e.g. `org/repo`).    |
+| `language`      | `string` | No       | Primary language hint.                      |
+| `testFramework` | `string` | No       | Test framework (e.g. jest, vitest, pytest). |
+| `maxTestCases`  | `number` | No       | Maximum test cases to return (1-30).        |
+
+**Returns:** `summary`, `testCases[]` (name, type, file, description, pseudoCode, priority), `coverageSummary`.
+
+## Resources
+
+| URI                       | Type            | Description                |
+| ------------------------- | --------------- | -------------------------- |
+| `internal://instructions` | `text/markdown` | Server usage instructions. |
+
+## Prompts
+
+| Name           | Arguments           | Description                                         |
+| -------------- | ------------------- | --------------------------------------------------- |
+| `get-help`     | —                   | Return the server usage instructions.               |
+| `review-guide` | `tool`, `focusArea` | Guided workflow for a specific tool and focus area. |
+
+## Configuration
+
+### CLI Arguments
+
+| Option             | Description            | Env Var Equivalent |
+| ------------------ | ---------------------- | ------------------ |
+| `--model`, `-m`    | Override default model | `GEMINI_MODEL`     |
+| `--max-diff-chars` | Override max diff size | `MAX_DIFF_CHARS`   |
+
+### Environment Variables
+
+| Variable                        | Description                                          | Default      | Required |
+| ------------------------------- | ---------------------------------------------------- | ------------ | -------- |
+| `GEMINI_API_KEY`                | Gemini API key                                       | —            | Yes      |
+| `GOOGLE_API_KEY`                | Alternative API key (if `GEMINI_API_KEY` not set)    | —            | No       |
+| `GEMINI_MODEL`                  | Override default model selection                     | —            | No       |
+| `GEMINI_HARM_BLOCK_THRESHOLD`   | Safety threshold (BLOCK_NONE, BLOCK_ONLY_HIGH, etc.) | `BLOCK_NONE` | No       |
+| `MAX_DIFF_CHARS`                | Max chars for diff input                             | `120000`     | No       |
+| `MAX_CONCURRENT_CALLS`          | Max concurrent Gemini requests                       | `10`         | No       |
+| `MAX_CONCURRENT_BATCH_CALLS`    | Max concurrent inline batch requests                 | `2`          | No       |
+| `MAX_CONCURRENT_CALLS_WAIT_MS`  | Max wait time for a free Gemini slot                 | `2000`       | No       |
+| `MAX_SCHEMA_RETRY_ERROR_CHARS`  | Max chars from schema error injected into retry text | `1500`       | No       |
+| `GEMINI_BATCH_MODE`             | Request mode for Gemini calls (`off`, `inline`)      | `off`        | No       |
+| `GEMINI_BATCH_POLL_INTERVAL_MS` | Poll interval for batch job status                   | `2000`       | No       |
+| `GEMINI_BATCH_TIMEOUT_MS`       | Max wait for batch completion                        | `120000`     | No       |
+
+### Models
+
+| Tool                      | Model                    | Thinking Level |
+| ------------------------- | ------------------------ | -------------- |
+| `analyze_pr_impact`       | `gemini-3-flash-preview` | `minimal`      |
+| `generate_review_summary` | `gemini-3-flash-preview` | `minimal`      |
+| `generate_test_plan`      | `gemini-3-flash-preview` | `medium`       |
+
+## Workflows
+
+### Quick PR Triage
+
+1. Call `analyze_pr_impact` to get severity and category breakdown.
+2. If low/medium — call `generate_review_summary` for a quick digest.
+3. If high/critical — proceed to deep inspection.
+
+### Testing
+
+1. Call `generate_test_plan` to create a verification strategy.
+2. Implement tests based on returned test cases and coverage summary.
+
+## Development
+
+```bash
+npm ci            # Install dependencies
+npm run dev       # TypeScript watch mode
+npm run dev:run   # Run built server with .env and --watch
+```
+
+| Script               | Command                             | Purpose                        |
+| -------------------- | ----------------------------------- | ------------------------------ |
+| `npm run build`      | `node scripts/tasks.mjs build`      | Clean, compile, validate, copy |
+| `npm test`           | `node scripts/tasks.mjs test`       | Build + run all tests          |
+| `npm run test:fast`  | `node --test --import tsx/esm ...`  | Run tests without build        |
+| `npm run lint`       | `eslint .`                          | Lint all files                 |
+| `npm run lint:fix`   | `eslint . --fix`                    | Lint and auto-fix              |
+| `npm run format`     | `prettier --write .`                | Format all files               |
+| `npm run type-check` | `node scripts/tasks.mjs type-check` | Type-check without emitting    |
+| `npm run inspector`  | Build + launch MCP Inspector        | Debug with MCP Inspector       |
+
+### Debugging with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## Build & Release
+
+Releases are triggered via GitHub Actions `workflow_dispatch` with version bump selection (patch/minor/major/custom).
+
+The pipeline runs lint, type-check, test, and build, then publishes to three targets in parallel:
+
+- **npm** — `@j0hanz/code-assistant-mcp` with OIDC trusted publishing and provenance
+- **Docker** — `ghcr.io/j0hanz/code-assistant-mcp` (linux/amd64, linux/arm64)
+- **MCP Registry** — `io.github.j0hanz/code-assistant`
+
+## Troubleshooting
+
+| Issue                                      | Solution                                                                             |
+| ------------------------------------------ | ------------------------------------------------------------------------------------ |
+| `Missing GEMINI_API_KEY or GOOGLE_API_KEY` | Set one of the API key env vars in your MCP client config.                           |
+| `E_INPUT_TOO_LARGE`                        | Diff exceeds budget. Split into smaller diffs.                                       |
+| `Gemini request timed out`                 | Deep analysis tasks may take 60-120s. Increase your client timeout.                  |
+| `Too many concurrent Gemini calls`         | Reduce parallel tool calls or increase `MAX_CONCURRENT_CALLS`.                       |
+| No tool output visible                     | Ensure your MCP client is not swallowing `stderr` — the server uses stdio transport. |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { getErrorMessage } from './lib/errors.js';
+import { createServer } from './server.js';
+const SHUTDOWN_SIGNALS = ['SIGINT', 'SIGTERM'];
+// --- CLI Parsing ---
+const ARG_OPTION_MODEL = 'model';
+const ARG_OPTION_MAX_DIFF_CHARS = 'max-diff-chars';
+const PROCESS_ARGS_START_INDEX = 2;
+const CLI_ENV_MAPPINGS = [
+    { option: ARG_OPTION_MODEL, envVar: 'GEMINI_MODEL' },
+    { option: ARG_OPTION_MAX_DIFF_CHARS, envVar: 'MAX_DIFF_CHARS' },
+];
+const CLI_OPTIONS = {
+    [ARG_OPTION_MODEL]: {
+        type: 'string',
+        short: 'm',
+    },
+    [ARG_OPTION_MAX_DIFF_CHARS]: {
+        type: 'string',
+    },
+};
+function setStringEnv(name, value) {
+    if (typeof value !== 'string') {
+        return;
+    }
+    process.env[name] = value;
+}
+function applyCliEnvironmentOverrides(values) {
+    for (const mapping of CLI_ENV_MAPPINGS) {
+        setStringEnv(mapping.envVar, values[mapping.option]);
+    }
+}
+function parseCommandLineArgs() {
+    const { values } = parseArgs({
+        args: process.argv.slice(PROCESS_ARGS_START_INDEX),
+        options: CLI_OPTIONS,
+        strict: false,
+    });
+    applyCliEnvironmentOverrides(values);
+}
+let shuttingDown = false;
+async function shutdown(server) {
+    if (shuttingDown) {
+        return;
+    }
+    shuttingDown = true;
+    await server.shutdown();
+    process.exit(0);
+}
+function registerShutdownHandlers(server) {
+    for (const signal of SHUTDOWN_SIGNALS) {
+        process.once(signal, () => {
+            shutdown(server).catch((error) => {
+                console.error(`[fatal] ${getErrorMessage(error)}`);
+                process.exit(1);
+            });
+        });
+    }
+}
+async function main() {
+    parseCommandLineArgs();
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    registerShutdownHandlers(server);
+    await server.server.connect(transport);
+}
+main().catch((error) => {
+    console.error(`[fatal] ${getErrorMessage(error)}`);
+    process.exit(1);
+});

package/dist/lib/concurrency.d.ts

@@ -0,0 +1,13 @@
+export declare class ConcurrencyLimiter {
+    private readonly maxConcurrent;
+    private readonly waitTimeoutMs;
+    private readonly formatTimeoutError;
+    private readonly formatCancelError;
+    private activeCount;
+    private readonly waiters;
+    constructor(maxConcurrent: () => number, waitTimeoutMs: () => number, formatTimeoutError: (limit: number, timeoutMs: number) => string, formatCancelError: () => string);
+    get pendingCount(): number;
+    get active(): number;
+    acquire(signal?: AbortSignal): Promise<void>;
+    release(): void;
+}

package/dist/lib/concurrency.js

@@ -0,0 +1,77 @@
+export class ConcurrencyLimiter {
+    maxConcurrent;
+    waitTimeoutMs;
+    formatTimeoutError;
+    formatCancelError;
+    activeCount = 0;
+    waiters = new Set();
+    constructor(maxConcurrent, waitTimeoutMs, formatTimeoutError, formatCancelError) {
+        this.maxConcurrent = maxConcurrent;
+        this.waitTimeoutMs = waitTimeoutMs;
+        this.formatTimeoutError = formatTimeoutError;
+        this.formatCancelError = formatCancelError;
+    }
+    get pendingCount() {
+        return this.waiters.size;
+    }
+    get active() {
+        return this.activeCount;
+    }
+    acquire(signal) {
+        const limit = this.maxConcurrent();
+        if (this.activeCount < limit) {
+            this.activeCount++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            let isSettled = false;
+            const waiter = () => {
+                if (isSettled) {
+                    return;
+                }
+                isSettled = true;
+                clearTimeout(timeoutId);
+                signal?.removeEventListener('abort', onAbort);
+                this.activeCount++;
+                resolve();
+            };
+            const onAbort = () => {
+                if (isSettled) {
+                    return;
+                }
+                isSettled = true;
+                clearTimeout(timeoutId);
+                this.waiters.delete(waiter);
+                reject(new Error(this.formatCancelError()));
+            };
+            const onTimeout = () => {
+                if (isSettled) {
+                    return;
+                }
+                isSettled = true;
+                signal?.removeEventListener('abort', onAbort);
+                this.waiters.delete(waiter);
+                reject(new Error(this.formatTimeoutError(limit, this.waitTimeoutMs())));
+            };
+            if (signal) {
+                if (signal.aborted) {
+                    reject(new Error(this.formatCancelError()));
+                    return;
+                }
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+            const timeoutId = setTimeout(onTimeout, this.waitTimeoutMs());
+            this.waiters.add(waiter);
+        });
+    }
+    release() {
+        if (this.activeCount > 0) {
+            this.activeCount--;
+        }
+        const next = this.waiters.values().next().value;
+        if (next) {
+            this.waiters.delete(next);
+            next();
+        }
+    }
+}

package/dist/lib/config.d.ts

@@ -0,0 +1,43 @@
+export interface CachedEnvInt {
+    get(): number;
+    reset(): void;
+}
+/** Creates a cached integer value from an environment variable, with a default fallback. */
+export declare function createCachedEnvInt(envVar: string, defaultValue: number): CachedEnvInt;
+/** Fast, cost-effective model for summarization and light analysis. */
+export declare const FLASH_MODEL = "gemini-3-flash-preview";
+/** Default language hint. */
+export declare const DEFAULT_LANGUAGE = "detect";
+/** Default test-framework hint. */
+export declare const DEFAULT_FRAMEWORK = "detect";
+/** Extended timeout for deep analysis calls (ms). */
+export declare const DEFAULT_TIMEOUT_EXTENDED_MS = 120000;
+export declare const MODEL_TIMEOUT_MS: Readonly<{
+    readonly extended: 120000;
+}>;
+/** Thinking level for Flash triage. */
+export declare const FLASH_TRIAGE_THINKING_LEVEL: "minimal";
+/** Thinking level for Flash analysis. */
+export declare const FLASH_THINKING_LEVEL: "medium";
+/** Thinking level for Flash deep analysis. */
+export declare const FLASH_HIGH_THINKING_LEVEL: "high";
+/** Output cap for Flash API breaking-change detection. */
+export declare const FLASH_API_BREAKING_MAX_OUTPUT_TOKENS = 65536;
+/** Output cap for Flash complexity analysis. */
+export declare const FLASH_COMPLEXITY_MAX_OUTPUT_TOKENS = 65536;
+/** Output cap for Flash test-plan generation. */
+export declare const FLASH_TEST_PLAN_MAX_OUTPUT_TOKENS = 65536;
+/** Output cap for Flash triage tools. */
+export declare const FLASH_TRIAGE_MAX_OUTPUT_TOKENS = 65536;
+/** Output cap for Flash patch generation. */
+export declare const FLASH_PATCH_MAX_OUTPUT_TOKENS = 65536;
+/** Output cap for Flash deep review findings. */
+export declare const FLASH_REVIEW_MAX_OUTPUT_TOKENS = 65536;
+/** Temperature for analytical tools. */
+export declare const ANALYSIS_TEMPERATURE: 1;
+/** Temperature for creative synthesis (test plans). */
+export declare const CREATIVE_TEMPERATURE: 1;
+/** Temperature for code patch generation. */
+export declare const PATCH_TEMPERATURE: 1;
+/** Temperature for triage/classification tools. */
+export declare const TRIAGE_TEMPERATURE: 1;