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+; inspect the source before using it on your own files.

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.

Where this check stops

This local walkthrough does not establish the state of a live production system or replace the limits documented in the repository.

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.