Skip to content

Releases: lavantien/dotfiles

Version 3.0: Bridge Approach Configuration System

01 Jan 08:00

Choose a tag to compare

Version 3.0 - Major release with backward-compatible configuration system, comprehensive testing, and documentation.

Major Features

Bridge Approach Configuration System

  • Backward compatible: works without config file
  • Optional configuration: ~/.dotfiles.config.yaml for customization
  • Priority: command-line flags > config file > hardcoded defaults
  • Graceful fallbacks: config failures don't break scripts
  • Cross-platform: identical behavior on Windows, Linux, macOS

New Utilities

Backup & Restore

  • backup.sh/ps1: Timestamped backups with automatic cleanup (keeps 5 recent)
  • restore.sh/ps1: Interactive restore from available backups

Health Check

  • healthcheck.sh/ps1: System health verification
  • Output: PASS/FAIL/WARN with detailed messages
  • Formats: table (default), verbose, JSON

Uninstall

  • uninstall.sh/ps1: Safe removal with verification
  • Features: verify-only, dry-run, force mode
  • Safety: Only removes verified dotfile deployments

System Instructions Sync

  • sync-system-instructions.sh/ps1: Distribute CLAUDE.md, AGENTS.md, GEMINI.md, RULES.md
  • Options: commit, push for headless Claude Code automation

Testing Framework

  • 170+ test cases across bash and PowerShell
  • BATS (bash) and Pester (PowerShell) frameworks
  • Unit tests: bootstrap, update-all, git-hooks
  • Integration tests: complete workflows

Documentation

  • BRIDGE.md: Comprehensive bridge approach documentation
  • QUICKREF.md: Quick reference card and common tasks
  • FIX_SUMMARY.md: Detailed fix summary and verification
  • COMPLETION_SUMMARY.md: Complete verification summary
  • README.md: Restructured for clarity (concise, tables, no emojis)

Fixes & Improvements

Fixed Issues

  • Config library paths in bootstrap scripts (was broken)
  • Path typos in deploy.ps1/deploy.sh
  • Alias inconsistencies (PowerShell to match bash)
  • Removed dead code from configs

Improvements

  • Added -c/--commit flag to git-update-repos scripts
  • Enhanced error handling throughout
  • Added test-bridge.sh for verification
  • Idempotency: all scripts safe to run multiple times
  • Better logging and user feedback

Backward Compatibility

✅ All changes are fully backward compatible
✅ Existing workflows continue to work exactly as before
✅ No breaking changes
✅ Config file is completely optional

Quick Start

==== Bootstrap Windows Development Environment ====

Options:
Interactive: true
Dry Run: false
Categories: full
Skip Update: false

Aborted.

Upgrade

Already up to date.

==== Bootstrap Windows Development Environment ====

Options:
Interactive: true
Dry Run: false
Categories: full
Skip Update: false

Aborted.


Full Changelog

See COMPLETION_SUMMARY.md for complete details on all changes.

v2.2

01 Jan 06:31

Choose a tag to compare

  • Auto distribute system instruction
  • Fix auto update quirks

v2.1

01 Jan 01:31

Choose a tag to compare

Modularize and improve update-all script

v2.0

31 Dec 22:26

Choose a tag to compare

Automatically distribute system instructions to all cloned repos and commit/push via headless Claude Code

v1.0

31 Dec 21:19

Choose a tag to compare

chore: update readme