Overview - Haia Trace

haia-trace assembles Operation Receipts — one verdict per payment operation — from recorded events, and renders them in the terminal or as JSON.

Install

npm install -g @usehaia/trace-cli

npx @usehaia/trace-cli <command>

Both expose the haia-trace command. Requires Node ≥ 20.

Commands

sample

Assemble receipts from bundled fixtures — the zero-setup first taste.

build

Assemble one receipt per operation from a run’s events.

templates

List the operation templates shipped with the CLI.

Global flags

Flag	Meaning
`-v, --version`	Print the version and exit.
`-h, --help`	Help for the program or any command.

The `.trace/` directory

The CLI reads and writes a project-local .trace/ directory — no daemon, no database, no network:

.trace/
  events/<run_id>.ndjson      # recorded events; one run = one file (the input)
  receipts/<context_id>.json  # assembled receipts, one per operation (the output)

A run file is newline-delimited JSON — one event per line, append-only. It’s the source of truth; a Receipt is a derived, reproducible artifact, so re-building the same run always yields the same Receipt.

sample

⌘I

​Install

​Commands

sample

build

templates

​Global flags

​The .trace/ directory

Install

Commands

Global flags

The `.trace/` directory