Contact
Open source · Product & Operations

Task Handoff Normalizer

Normalize task handoffs with owner, context, acceptance and due date.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Normalize two explicit local task-export shapes into one versioned handoff record. The output retains owner, objective, context reference IDs, acceptance criteria, deadline and current state. It preserves the supplied deadline string alongside a UTC value, so an offset is not lost during normalization. No task is created, assigned, or sent.

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/task-handoff-normalizer.mjs --root examples --input passing.json
node bin/task-handoff-normalizer.mjs --root examples --input incomplete.json --human
npm run check

Read the result

--root is the evidence directory; --input is relative to it. Optional --out report.json writes the same JSON report inside the root after destination checks. JSON always goes to stdout; --human adds a short summary to stderr. --help lists options.