dotsync 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1914fdcd07e4e248821a67f44903e98dd2445bb33c8fc5932af156d6da2c759
-  data.tar.gz: e6cf1fa237ebf65356524856ef1f57243dc0c8a22ce113836c0ff32622d94ec6
+  metadata.gz: 9518c58d4295da09d14d43ec60643bf6dd93ddf447d47b5e941e1817cf3a7569
+  data.tar.gz: a1effa3db0429cad4816db2128c3afd045d3b2e01dd7e80a12ddfd314974f704
 SHA512:
-  metadata.gz: 55195d77f422a37d3746180f4ce42b9cc6b5b5a80ee02b4a735973d3403adfebe305653e7595345b75961be0d2d2c2179ee71c33513c94a952b20265435985e7
-  data.tar.gz: 10516395feb7ea6aaacab2ee7636eefda0a555c53d7d8f6b462532fb3e31e7c86bfd9dab4320d78322f8e6df6d940f3e116b597cf318fe0ef60e97627bb2d2da
+  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,10 @@
+## [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

data/lib/dotsync/actions/pull_action.rb

@@ -76,6 +76,7 @@ module Dotsync
           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)

data/lib/dotsync/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dotsync
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - David Sáenz