feat: add agent recorder tool - #29
Merged
Merged
Conversation
thiennamdinh
force-pushed
the
agent-recorder
branch
from
June 24, 2026 18:40
bea6e42 to
25c98bf
Compare
Summary - Add `tools/agent-recorder`, a passive Rust tool for normalizing existing AI-agent session artifacts into flat provenance graph records. - Support Pi, Codex, Claude Code, Gemini CLI, and OpenCode adapters with sanitized synthetic fixtures and import coverage. - Add print mode by omitting `--recorder`, local `file` record storage, Sync Web record storage/reading, and OpenTelemetry export. - Add optional initial key-evolving HMAC integrity metadata with local state, read-time verification, status, and emergency rekey workflows. - Add packaged JSON-LD/Turtle vocabulary files, public Tools documentation, README/reference docs, examples, and Rustdoc for public boundaries. - Add a separate `Agent Recorder Binaries` workflow for `agent-recorder-v*` release assets and switch ledger binary releases to `ledger-v*` tags. - Keep the platform version at 1.4.0, journal-sdk at 1.3.0, and agent-recorder at 0.1.0. Testing - `cd tools/agent-recorder && cargo fmt --check` - `cd tools/agent-recorder && jq empty schema/agent-recorder.context.jsonld examples/integrity-agent-record.jsonld tests/fixtures/opencode-combined-export/export.json tests/fixtures/generated-gemini/*.jsonl` - `cd tools/agent-recorder && cargo test --examples` - `cd tools/agent-recorder && RUSTDOCFLAGS='-D warnings' cargo doc --no-deps` - `cd tools/agent-recorder && cargo test` - `cd docs/info && rm -rf .astro && npm run build` - CLI smoke: print mode import, `file` recorder import, integrity import/verify/read, missing `--recorder-data` failure, stale `--source` failure, and stale `jsonl` recorder failure. Notes/Risks - Integrity support is documented as initial 0.1.0 tamper-evidence and forward-integrity plumbing for review and experimentation, not a cryptographically audited production guarantee. - Real hosted Sync Web write smoke was not run because `AGENT_RECORDER_SYNC_WEB_API_KEY` was not set; CLI wiring was checked up to the expected missing-key error. - Docs build completes with the existing Node/Pagefind `DEP0190` warning from the search-index tooling. - The existing ledger binary release was renamed from `v1.4.0` to `ledger-v1.4.0` and the release title is now `Ledger v1.4.0`.
thiennamdinh
force-pushed
the
agent-recorder
branch
from
June 24, 2026 18:46
25c98bf to
d6aabcc
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
tools/agent-recorder, a passive Rust tool for normalizing existing AI-agent session artifacts into flat provenance graph records.--recorder, localfilerecord storage, Sync Web record storage/reading, and OpenTelemetry export.Agent Recorder Binariesworkflow foragent-recorder-v*release assets and switch ledger binary releases toledger-v*tags.Testing
cd tools/agent-recorder && cargo fmt --checkcd tools/agent-recorder && jq empty schema/agent-recorder.context.jsonld examples/integrity-agent-record.jsonld tests/fixtures/opencode-combined-export/export.json tests/fixtures/generated-gemini/*.jsonlcd tools/agent-recorder && cargo test --examplescd tools/agent-recorder && RUSTDOCFLAGS='-D warnings' cargo doc --no-depscd tools/agent-recorder && cargo testcd docs/info && rm -rf .astro && npm run buildfilerecorder import, integrity import/verify/read, missing--recorder-datafailure, stale--sourcefailure, and stalejsonlrecorder failure.Notes/Risks
AGENT_RECORDER_SYNC_WEB_API_KEYwas not set; CLI wiring was checked up to the expected missing-key error.DEP0190warning from the search-index tooling.v1.4.0toledger-v1.4.0and the release title is nowLedger v1.4.0.