v0.5.0 — stable JSON pipe contract

What's new in v0.5.0

Stable machine-readable output for piping.

Added

• --format json for �nalyze, �nalyze-many, and stats
• Envelope: { ""schema_version"": ""1"", ""ok"": true, ""command"": ""analyze"", ... }
• Library: OUTPUT_SCHEMA_VERSION, parseOutputFormat, oJsonLine
• README documents the pipe contract

Changed

• --json is a shorthand for --format json

Tests

88 passing (
pm test), typecheck clean.

Full changelog: https://github.com/medthemed/agent-trace-map/blob/v0.5.0/CHANGELOG.md

v0.4.0 — directory batch analysis

What's new in v0.4.0

Batch analysis across a directory of traces.

Added

• �tm analyze-many analyzes every *.jsonl file in a directory
• Per-trace rollup table (spans, findings, status)
• Aggregate findings table grouped by severity and detector
• Library: �nalyzeMany, listTraceFiles, ormatFindingsTable

Tests

78 passing (
pm test), typecheck clean.

Full changelog: https://github.com/medthemed/agent-trace-map/blob/v0.4.0/CHANGELOG.md

v0.3.0 — detector threshold config

What's new in v0.3.0

Pin detector thresholds in a project config file.

Added

• Optional atm.config.json for loop_threshold, stall_ms, stall_gap_ms, assumption_failure_min
• atm analyze / atm stats accept --config <path> and auto-load from cwd
• Library: parseConfig, loadConfig, configToDetectorOptions, ConfigError

Changed

• Explicit CLI flags override config-file values

Tests

72 passing (npm test), typecheck clean.

Full changelog: https://github.com/medthemed/agent-trace-map/blob/v0.3.0/CHANGELOG.md

v0.2.0 — typed analysis errors and frozen public API

What's new in v0.2.0

Typed analysis errors and a frozen public API surface.

Added

• AnalysisError / TraceParseError (instanceof-friendly)
• assertParseable throws when a trace has zero valid events
• Frozen export catalog: PUBLIC_API, PUBLIC_API_NAMES
• Integration suite over every examples/*.jsonl fixture

Tests

60 passing (npm test), typecheck clean.

Full changelog: https://github.com/medthemed/agent-trace-map/blob/v0.2.0/CHANGELOG.md

v0.1.1 - Stats summary and docs

Added

• atm stats compact operational summary (counts, durations, tools, findings)
• --top N to limit tools listed
• Library API: summarizeStats, formatStats
• README sample-trace walkthrough and CI badge

Notes

• 42 tests passing.
• analyze remains the deep report; stats is the quick triage rollup.

v0.1.0 - Initial release

Initial public release of agent-trace-map: map agent reasoning loops from JSONL traces.

Highlights

• Trace event schema (plan | tool | reflect | fail | commit) with span/parent linkage
• JSONL parser with per-line error collection
• Reasoning graph builder with orphan and cycle handling
• Detectors: loop, stall (duration + idle gap), assumption failure, critical path
• atm analyze CLI with text and --json output
• Example traces under examples/
• Vitest suite covering parse errors, loop/stall detection, and clean traces

Install

npm install agent-trace-map