Skip to main content
Agent Journal 2.0 is the current Journal line, on main. It is not yet released, and breaking changes are expected before 2.0.0. Checked against markpollack/agent-journal@e161c779, snapshot 2.0.0-20261115.230849-26.
This walkthrough replays a sanitized real Claude Code 2.1.304 stream, kept in the agent-journal repository as a test fixture, into a package, then checks the package against the native input with the independent oracle. It needs no CLI and no account.

1. Resolve the snapshot

2.0 is not on Maven Central. Resolve the timestamped snapshot from the Central snapshot repository, and pin the timestamped version so the result stays reproducible:
See Using development snapshots from main for pinning one build and reading its provenance. Put that in the pom.xml of an empty project, then write the runtime classpath to a file:

2. Get the recording

The input is the fixture claude-live-2.1.304-denial: a spec, the native stream and the frozen expected-source manifest.
The spec’s source path is a placeholder. Set sources[0].path to native/stream.jsonl:

3. Replay and verify

Replay prints:
and exits 0. out/ now holds events.jsonl and run.json; run.json states package kind agent-journal/ocsf-package, layout 1.0.0. Verify prints its summary, ends with acceptance: ACCEPTED, writes the full report to report.json, and exits 0.

Reading the exit code

Only exit 0 is acceptance. Zero defects alone is not:

Next

  • Reading packages: the same package from Java, with the usage view and the oracle.
  • Capture: write a package from a live CLI instead of a recording.