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

说明与用途

Serval 是一个本地 CLI，分析依赖图、Git 历史、CI 配置和关键路径规则，生成文件更改的确定性风险评分，帮助开发者快速评估影响范围并将风险检查集成到 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.

来源