I Built a CLI to Answer One Question: What Will This Change Break?

Описание и применение

Serval — это локальный CLI, который анализирует граф зависимостей, историю Git, конфигурацию CI и правила критических путей, выдавая детерминированный риск изменения. Это помогает разработчикам быстро понять потенциальный «blast radius» и интегрировать проверку в CI.

Задача

Developers struggle to understand the blast radius of a code change, leading to accidental failures in large or unfamiliar codebases.

Результат

Serval enables developers to quickly assess the potential impact of a file change with a deterministic risk score, reducing accidental failures and making risk visible before merge.

Рабочий процесс

• 1. Install Serval via Homebrew or download binary
• 2. Run serval inspect <file> to analyze a target file
• 3. Review the structured output showing direct/indirect impacts, CI workflows, git history, and risk score
• 4. Optionally use --explain for AI-generated natural language explanations
• 5. Integrate serval diff --fail-on high into CI to gate merges based on risk

Доказательства

Serval is a local-first CLI that tries to answer one simple question: If I change this file, what am I likely to affect?

Источник

The core score produced by Serval is deterministic. The same repository state and configuration produce the same result.

Источник

Serval does support AI explanations. The AI cannot change the score.

Источник