Skip to content

v0.2.0

Choose a tag to compare

@jonathanabila jonathanabila released this 10 Feb 02:03
· 203 commits to main since this release
v0.2.0
1607495

Fixed

  • Flaky test elimination: Fixed test_hooks_skip_without_config in tests/integration/test-git-ops.sh by using git show "HEAD:file" > file instead of git checkout HEAD -- to bypass smudge filter and ensure deterministic test behavior

Changed

  • Documentation updates: Updated README.md and CONTRIBUTING.md to accurately reflect filter driver implementation, including filter scripts in architecture diagrams and emphasizing Docker tests as authoritative

Added

  • skip-worktree integration: Overridden files no longer appear as modified in git status
    • Uses git update-index --skip-worktree when applying overrides
    • Uses git update-index --no-skip-worktree when restoring originals
    • Applied automatically in hooks (post-checkout, pre-commit, post-commit)
    • Applied in CLI commands (apply, restore)
  • Skip-worktree documentation: Added section to README explaining this feature
  • Filter driver scripts: Added local-override-filter-smudge and local-override-filter-clean
    • Smudge outputs local override content when configured override files exist
    • Clean outputs original HEAD:<path> content when overrides are active
    • Both filters support passthrough mode and GIT_LOCAL_OVERRIDE_DISABLE=1
  • Filter helper commands: Added CLI subcommands filter-smudge and filter-clean
    • Mirrors hook filter behavior for direct invocation and testing
  • sync-filters CLI command: Added git-local-override sync-filters to manually sync filter configuration
    • Regenerates .git/info/attributes from .local-overrides.yaml
    • Configures git filter driver if not already set up
    • Useful for fixing out-of-sync filter state
  • GIT_LOCAL_OVERRIDE_DISABLE environment variable: Bypass filter drivers when set to 1
    • Allows getting true original content with GIT_LOCAL_OVERRIDE_DISABLE=1 git checkout HEAD -- <file>
    • Documented in CLI help and README

Changed

  • Hook test setup: Unit test bootstrap now installs filter scripts into .git/hooks
  • Disable-env test invocation: Filter disable test now exports GIT_LOCAL_OVERRIDE_DISABLE=1 to the filter process

Fixed

  • Branch switching with divergent overridden files: Fixed checkout/switch failures when overridden files differ between branches
    • Filter drivers now make git consider overridden files "clean" via clean(smudge(X)) == X roundtrip
    • Works across all git operations: checkout, switch, pull, merge, rebase, stash
    • Resolves "Your local changes would be overwritten by checkout" errors
  • Test compatibility with skip-worktree: Fixed integration tests failing due to skip-worktree
    • Tests now clear skip-worktree before git add or git checkout operations
    • Affected tests: git operations and pre-commit framework integration tests
  • Documentation accuracy: Comprehensive review and update of all documentation
    • Fixed outdated config format in install.sh summary (now shows override:/replaces: format)
    • Fixed uninstall.sh references to legacy registry/allowlist system and non-existent uninit command
    • Updated pre-commit version references from v0.0.2 to v0.1.0 across all docs
    • Fixed placeholder URLs (https://.../) with actual GitHub URLs
    • Fixed CLI help text showing non-existent v1.0.0 version
    • Fixed Makefile install-manual creating legacy allowlist files
    • Updated CONTRIBUTING.md project structure to reflect actual directory layout
    • Updated AGENTS.md/CLAUDE.md key functions list to include read_pattern(), get_active_overrides(), cmd_status(), cmd_init_config()
    • Fixed incomplete version history summary in CHANGELOG.md