Open source · Product & Operations

Manual Override Auditor

Record manual overrides with reason, actor, evidence and follow-up.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Offline, read-only validation of exported policy decisions and override events. The original decision is a separate record: an override refers to it and carries an originalResult copy, which must agree with that record. The audit assesses a supplied time, so its output is reproducible.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/manual-override-auditor.mjs --root examples --input passing.json --as-of 2026-01-02T00:00:00Z
node bin/manual-override-auditor.mjs --root examples --input failing.json --as-of 2026-01-02T00:00:00Z --human
npm run check

Read the result

--root names the evidence directory. --input is relative to it. --as-of is a required exact UTC timestamp. Optional --out report.json writes the same JSON report inside the root after destination checks. JSON always goes to stdout; --human adds a brief summary to stderr. --help lists options. A bad CLI option/configuration gives exit 2 with empty stdout. An unreadable, non-UTF-8, malformed or unsupported input gives an incomplete JSON report and exit 2.