Open source · Performance & Reliability

Incident Severity Normalizer

Normalize incident severity using impact, duration and recovery evidence.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Classify incident records from a policy and an incident export, both supplied as local JSON files. The tool makes the four dimensions and the rule behind each severity visible. It is useful when teams need a reproducible classification review; it does not decide whether an incident is safe or resolved.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.

Run the checked-in example

node bin/incident-severity-normalizer.mjs --policy examples/clean/policy.json --incidents examples/clean/incidents.json --json

Read the result

That complete example exits 0. The first row's original severity is SEV2, with a separately retained reviewed override to SEV3; the second is a complete SEV1. pass means classification completed, not that either incident is safe.

Where this check stops

This is a policy-based classification of an exported snapshot, not a live incident-management integration or a recommendation to downgrade an incident. It cannot infer a missing impact, verify whether the export is current, judge the policy's appropriateness, or validate a free-form explanation for an override. It does not contact a host or database, execute actions, or write a report file. Treat incomplete as a request for better evidence, not as absence of severity.

Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.

Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.