v0.4.0

What's new

Added

• assess tool - Zero-cost diff analysis pre-flight. Runs git diff --numstat locally (no CLI spawn, no model call) and returns diff stats, complexity classification (trivial/moderate/complex), and a recommended review depth with estimated wall-clock time. Use before review to set timeout expectations.
• depth parameter on review - Three tiers replace the binary quick/agentic split:
  • scan: diff-only, single-pass, no repo exploration. Constant 180s timeout.
  • focused: diff + CLI reads changed files in plan mode (no shell). Timeout scales 120s + 15s * files, capped at 300s (240s fallback).
  • deep (default): full agentic exploration with --yolo. Timeout scales 240s + 45s * files, capped at 1800s (600s fallback).
• scaleTimeoutForDepth, defaultTimeoutForDepth, resolveDepth - New exports for per-depth timeout and input resolution.

Changed

• BREAKING: ReviewResult.mode values - "agentic" | "quick" → "scan" | "focused" | "deep". Callers inspecting result.mode need to update. Pre-1.0 mechanically allows a minor bump; called out explicitly.
• Deep (previously agentic) timeout scaling - Per-file budget raised 30s → 45s and base raised 180s → 240s. A 10-file diff goes from 480s to 690s.
• Partial response hint - Timeout annotations now read consider depth: "scan" or narrow the base (was consider quick: true). Scan timeouts no longer annotated.
• Tool description on review - Rewritten to explain the three depths and new timeout formulas.

Deprecated

• quick parameter on review - Superseded by depth. Still works: quick: true → depth: "scan", quick: false → depth: "deep". depth wins when both are set.

Note

Focused mode containment is prompt-driven, not CLI-enforced. Plan mode removes shell access but does not scope read_file / grep_search / list_directory to changed files — Gemini could still read any non-gitignored file. Containment relies on the prompt instruction plus reduced tool surface.

Full Changelog: v0.3.0...v0.4.0