0.2.1: structured handoff records + huggingface pip extra#6
Merged
Conversation
Adds a 'format' job to the tests workflow that runs 'ruff format --check sdk/' on every push/PR, so style drift fails CI instead of reaching review. To make the gate green, ran 'ruff format' across sdk/ (15 files reformatted, whitespace/line-wrap only — no logic changes). Verified the full suite still passes (66 tests). Also lands sdk/tests/test_handoff_v2.py — the 9-test suite for the 0.2.1 structured handoff (complete/blocked/needs_review state, next_action/--to, git-derived changed_files, mutual-exclusion, no mandatory assumptions field). The fixture chdirs to an isolated dir and writes config to both the CWD-local and HOME paths, so a stray ./.tracecraft.json can't shadow it (this was making the tests hit a real endpoint and fail). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Arrmlet
added a commit
that referenced
this pull request
Jun 9, 2026
…+d8a9fa7; trees verified identical)
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
1 participant
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.
v0.2.1 — Structured handoff records
tracecraft completenow writes a structured handoff instead of just afree-text note, so the next agent can act without a human relaying context.
New flags on
complete--to <agent>— who picks the step up next--next-action "<text>"— one line: what the next agent should do first--blocked— mark the step blocked rather than complete--needs-review— mark the step as needing review--changed-files-from-git— record changed files fromgit diff(no-op outside a repo)Handoff schema
Handoff records are now schema v2 (
state/next_agent/next_action/changed_files). The v1 keys are unchanged — old handoffs and readers keepworking. A blocked or needs-review step records that status and omits
completed_at.Machine-checkable fields (changed files) are auto-sourced from git rather
than hand-typed; open questions stay in the free-text
--note. There is nomandatory assumptions field by design.
HuggingFace install
Adds the
huggingfaceextra:pip install 'tracecraft-ai[huggingface]'
which pulls
huggingface_hubfor the HF Buckets backend(
tracecraft init --backend hf --bucket <user>/<name>).Full changelog: v0.2.0...v0.2.1