google-gemini/gemini-cli

Fix unsafe type assertions (Refactoring Plan)

Open

#19708 opened on Feb 20, 2026

View on GitHub
 (18 comments) (0 reactions) (1 assignee)TypeScript (103,992 stars) (13,657 forks)batch import
area/coreeffort/largehelp wantedkind/bugpriority/p2status/bot-triaged

Description

Tracking issue for removing no-unsafe-type-assertion suppressions introduced in PR #18688.

The goal is to replace as Type casts with runtime validation (Zod, instanceof, type guards).

This is a meta-issue to track the progress of the following sub-tasks.

  • #19709 - Phase 1.1: Error Handling (Core Utilities)
  • #19710 - Phase 1.2: JSON & Config (Core Utilities)
  • #19711 - Phase 2.1: Tool Execution (Core Tools)
  • #19712 - Phase 2.2: File System (Core File System)
  • #19713 - Phase 3.1: CLI Config
  • #19714 - Phase 3.2: CLI Activity Logger
  • #19715 - Phase 4.1: A2A Server
  • #19717 - Phase 4.2: VS Code Companion (Likely empty/already done)
  • #19733 - Phase 5: CLI Commands
  • #19734 - Phase 6: CLI UI
  • #19735 - Phase 7: Core MCP & Code Assist

Contributor guide

Tech stack
typescriptnodejs
Domain
backendtoolingdeveloper experience
Issue type
refactor
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
needs investigation
Prerequisites
TypeScriptZod or similar validation library
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
20
Research direction
This is a meta issue tracking the removal of unsafe type assertions in the Gemini CLI codebase. The issue lists several subtasks (e.g., #19733, #19734, #19735) that are still open. Each subtask involves replacing `as Type` casts with runtime validation using Zod, type guards, or instanceof. To contribute, first review the existing refactoring pattern from completed subtasks (e.g., #19709–#19714) by examining their pull requests. Then choose an open subtask, ensure no one is assigned, and implement the changes in the relevant files (likely under `src/`). The maintainers have provided guidance in comments; read through the discussion to understand acceptance criteria.