dotsync 0.4.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b49b79875a41ac8a64361efc61108dc18ee203b08804daf40e709e18972ed88
-  data.tar.gz: f3eaf2a153a9757d98018900245ac7020596aab2844dbf1841d99e5e7ae055c3
+  metadata.gz: 9518c58d4295da09d14d43ec60643bf6dd93ddf447d47b5e941e1817cf3a7569
+  data.tar.gz: a1effa3db0429cad4816db2128c3afd045d3b2e01dd7e80a12ddfd314974f704
 SHA512:
-  metadata.gz: 3315fa7273357e2a61c494e1fa3abdd31ba2e43089888f8dc5174e8bc70ce69fe4bbf553a3db2d647d437b9dae81811056dcc43f7d31bef56736346628ef76b1
-  data.tar.gz: fa0bdc870da7374523db60c823d527e0ec8c1da8809548b3f4aeaaec03872cf3f96e08bff0c27d73524c80677ef6e765725416d74b57f83d66f57f86cfb31772
+  metadata.gz: c48aec258167adfcbb5d2d00f7e5126a264e38a7635c4055d317529ad50d35e45eb62a2b93ce0c5722f858d5ed100aa8a82733f053f6ff5e973387e3df6b7976
+  data.tar.gz: 80e316f48c64029624276a6bb4da2b906a76093d0b6e55531cb397bdcb2e3b4e7a0969c228992ad611505b0c125e573849f87f1728c950dab30b29d59a8467b7

data/AGENTS.md

@@ -1,93 +1,27 @@
-# Agents
-
-This document describes AI agents and automation helpers that can assist with developing and maintaining the Dotsync project.
-
-## Development Agents
-
-### Code Review Agent
-
-**Purpose**: Review code changes for quality, consistency, and adherence to Ruby best practices.
-
-**When to use**:
-- Before submitting pull requests
-- After implementing new features
-- When refactoring existing code
-
-**What it checks**:
-- Ruby style guide compliance (follows .rubocop.yml)
-- Test coverage for new functionality
-- Proper error handling
-- Documentation completeness
-- Performance considerations
-
-### Test Generation Agent
-
-**Purpose**: Generate and enhance RSpec tests for Dotsync functionality.
-
-**When to use**:
-- When adding new actions or utilities
-- When test coverage is insufficient
-- When refactoring existing code
-
-**Focus areas**:
-- Unit tests for models (Mapping, Diff)
-- Integration tests for actions (PullAction, PushAction, WatchAction)
-- Edge cases and error scenarios
-- File system operations
-
-### Documentation Agent
-
-**Purpose**: Maintain and improve project documentation.
-
-**When to use**:
-- After adding new features
-- When configuration options change
-- When updating usage examples
-
-**Responsibilities**:
-- Keep README.md synchronized with code
-- Update inline code documentation
-- Maintain CHANGELOG.md
-- Generate usage examples
-
-## Maintenance Agents
-
-### Dependency Update Agent
-
-**Purpose**: Monitor and suggest updates for gem dependencies.
-
-**What it monitors**:
-- Security vulnerabilities in dependencies
-- New versions of runtime and development dependencies
-- Ruby version compatibility
-
-### Release Agent
-
-**Purpose**: Assist with the release process following RELEASING.md guidelines.
-
-**Checklist**:
-- Version number updated in version.rb
-- CHANGELOG.md updated with changes
-- Tests passing
-- RuboCop compliance
-- Tag creation and push
-- Gem publication to rubygems.org
-
-## Usage
-
-To work with these agents effectively:
-
-1. **Be specific**: Provide clear context about what you're working on
-2. **Reference files**: Point to specific files or line numbers when discussing issues
-3. **Run tests**: Always run `rake spec` after changes
-4. **Follow conventions**: Adhere to existing code patterns and Ruby style guide
-
-## Contributing
-
-When working with agents on this project:
-
-- Review generated code carefully before committing
-- Ensure all tests pass (`rake spec`)
-- Run RuboCop (`bundle exec rubocop`)
-- Update documentation as needed
-- Follow the project's [Code of Conduct](CODE_OF_CONDUCT.md)
+# Coding Agent Guidelines
+
+## Commands
+- Run all tests: `rake spec` or `bundle exec rspec`
+- Run single test: `bundle exec rspec spec/path/to/file_spec.rb` or `bundle exec rspec spec/path/to/file_spec.rb:42`
+- Lint: `bundle exec rubocop` (auto-fix: `bundle exec rubocop -a`)
+- Build gem: `rake build`
+
+## Code Style
+- **Ruby version**: >= 3.2.0
+- **Frozen string literal**: Always include `# frozen_string_literal: true` at top of files
+- **Indentation**: 2 spaces, no tabs
+- **Strings**: Double quotes (`"string"`)
+- **Hash syntax**: Modern style (`{ a: 1 }`)
+- **Method definitions**: Always use parentheses for methods with parameters
+- **Spacing**: Space after colons, commas, around operators; `foo { bar }` not `foo {bar}`
+
+## Project Structure
+- Actions: `lib/dotsync/actions/` - Core operations (PullAction, PushAction, WatchAction)
+- Config: `lib/dotsync/config/` - Configuration management with XDG support
+- Models: `lib/dotsync/models/` - Domain models (Mapping, Diff)
+- Utils: `lib/dotsync/utils/` - Helpers (FileTransfer, DirectoryDiffer, Logger, PathUtils)
+- Tests: `spec/` - RSpec tests mirroring lib structure
+
+## Error Handling
+- Use custom errors from `lib/dotsync/errors.rb`: `ConfigError`, `FileTransferError`, `PermissionError`, `DiskFullError`, `SymlinkError`, `TypeConflictError`
+- Always use `raise ErrorClass, "message"` for explicit error handling

data/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [0.4.2] - 2026-03-22
+
+### Fixed
+
+- Fix `cp_r_regular_files` crash on pre-existing symlinks during backup (#35)
+  - Add `FileUtils.rm_f` before `FileUtils.ln_s` to handle leftover symlinks from partial backup runs
+
+## [0.4.1] - 2026-03-17
+
+### Fixed
+
+- Fix backup crash on macOS when directories contain socket files (#33)
+  - Replace `FileUtils.cp_r` with custom `cp_r_regular_files` that skips sockets, FIFOs, and device files
+  - Socket paths exceeding macOS 104-byte limit no longer cause backup failures
+  - Symlinks are properly preserved during backup
+
 ## [0.4.0] - 2026-03-01
 
 ### Added
@@ -473,6 +489,7 @@ Add gem executables
 
 Initial version
 
+[0.4.1]: https://github.com/dsaenztagarro/dotsync/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/dsaenztagarro/dotsync/compare/v0.3.3...v0.4.0
 [0.3.3]: https://github.com/dsaenztagarro/dotsync/compare/v0.3.2...v0.3.3
 [0.3.2]: https://github.com/dsaenztagarro/dotsync/compare/v0.3.1...v0.3.2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dotsync (0.4.0)
+    dotsync (0.4.1)
       fileutils (~> 1.7.3)
       find (~> 0.2.0)
       listen (~> 3.9.0)

data/lib/dotsync/actions/pull_action.rb

@@ -62,12 +62,30 @@ module Dotsync
           if File.file?(mapping.src)
             FileUtils.cp(mapping.dest, backup_path)
           else
-            FileUtils.cp_r(mapping.dest, backup_path)
+            cp_r_regular_files(mapping.dest, backup_path)
           end
         end
         true
       end
 
+      # Recursively copy a directory, skipping sockets, FIFOs, and device files.
+      # FileUtils.cp_r fails on macOS when socket paths exceed the 104-byte limit.
+      def cp_r_regular_files(src, dest)
+        FileUtils.mkdir_p(dest)
+        Dir.each_child(src) do |entry|
+          src_entry = File.join(src, entry)
+          dest_entry = File.join(dest, entry)
+          if File.symlink?(src_entry)
+            FileUtils.rm_f(dest_entry)
+            FileUtils.ln_s(File.readlink(src_entry), dest_entry)
+          elsif File.directory?(src_entry)
+            cp_r_regular_files(src_entry, dest_entry)
+          elsif File.file?(src_entry)
+            FileUtils.cp(src_entry, dest_entry, preserve: true)
+          end
+        end
+      end
+
       def purge_old_backups
         backups = Dir[File.join(backups_root, "*")].sort.reverse
         if backups.size > 10

data/lib/dotsync/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dotsync
-  VERSION = "0.4.0"
+  VERSION = "0.4.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dotsync
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - David Sáenz
@@ -367,7 +367,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Manage dotfiles like a boss
 test_files: []