BranchDojo v0.4.0

BranchDojo v0.4.0 adds the first advanced exercise set, expanding the catalog from six to nine exercises while preserving the local, disposable-repository, final-state validation model.

Added

• Added advanced exercise difficulty support.
• Added interactive-rebase-basic for cleaning noisy feature branch history.
• Added tag-release-fix for correcting a local release tag after a blocker fix.
• Added merge-vs-rebase for practicing clean feature branch integration.
• Added learning-path documentation for beginner, intermediate, and advanced exercise progression.

Validation behavior

• BranchDojo continues to validate final repository state, not exact command history.
• Advanced exercises validate history shape and Git refs where relevant.
• Valid final states with less-preferred history or tag shapes may produce warnings instead of failures.
• JSON output schema remains unchanged.
• Markdown check reports continue to work through branchdojo check --report <file>.

Included exercises

• conflict-basic
• revert-mistake
• wrong-branch-commit
• stash-switch
• cherry-pick-basic
• detached-head-recovery
• interactive-rebase-basic
• tag-release-fix
• merge-vs-rebase

Install from source

cargo install --git https://github.com/he8um/branchdojo --tag v0.4.0

Deferred

bisect-basic, external exercise packs, custom exercise definitions, GitHub integration, dashboards, telemetry, report templates, HTML/PDF reports, and release automation remain out of scope.

Full changelog

See CHANGELOG.md.

BranchDojo v0.3.0

BranchDojo v0.3.0 adds better feedback and review artifacts for local Git practice while preserving the project's disposable-repository, final-state validation model.

Added

• Shared exercise metadata for the released exercise catalog.
• Metadata-backed branchdojo list output with difficulty, category, and estimated time.
• Progress-aware hints based on observable repository state.
• Optional Markdown check reports through branchdojo check --report <file>.
• Report safety checks for existing files, unsafe paths, .git paths, directories, and missing parent directories.
• Expanded test coverage for metadata, hints, reports, JSON compatibility, and report safety.

Validation behavior

• BranchDojo continues to validate final repository state, not exact command history.
• Progress-aware hints inspect repository state but do not modify the repository.
• Check reports summarize the same validation result shown in terminal output.
• --json --report keeps stdout valid JSON.

Included exercises

• conflict-basic
• revert-mistake
• wrong-branch-commit
• stash-switch
• cherry-pick-basic
• detached-head-recovery

Install from source

cargo install --git https://github.com/he8um/branchdojo --tag v0.3.0

Deferred

JSON report files, HTML/PDF reports, report templates, dashboards, --force, new exercises, external exercise packs, and release automation remain out of scope.

Full changelog

See CHANGELOG.md.

BranchDojo v0.2.0

BranchDojo v0.2.0 adds intermediate Git workflow practice while preserving the project's local, disposable, final-state validation model.

Added

• stash-switch: practice preserving local work before switching branches.
• cherry-pick-basic: practice applying one specific commit without merging unrelated branch history.
• detached-head-recovery: practice recovering work committed from detached HEAD.
• Updated validation catalog and exercise documentation.
• Expanded integration coverage for all v0.2 exercises.

Validation behavior

• BranchDojo continues to validate final repository state, not exact command history.
• Valid final states with unusual history shape may return WARNING.
• Missing required final state still returns FAILED.

Included exercises

• conflict-basic
• revert-mistake
• wrong-branch-commit
• stash-switch
• cherry-pick-basic
• detached-head-recovery

Install from source

cargo install --git https://github.com/he8um/branchdojo --tag v0.2.0

Full changelog

Refer to CHANGELOG.md.

BranchDojo v0.1.0

[0.1.0] - 2026-07-08

Added

• Rust CLI with branchdojo list, new, check, reset, and hint.
• Beginner exercises: conflict-basic, revert-mistake, and wrong-branch-commit.
• Disposable local Git repository generation with local-only Git identity setup.
• .branchdojo.json workspace state file.
• Final-state validation with PASSED, WARNING, and FAILED results.
• Human-readable and JSON check output.
• Static hints for each exercise.
• Safe reset guarded by BranchDojo workspace metadata.
• Safety guards for unsafe paths, non-empty target directories, and non-BranchDojo workspaces.
• Unit and integration tests.
• GitHub Actions CI.