soft-sort 1.0.0

data/lib/soft_sort/watching/directory_watcher.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module SoftSort
+  class DirectoryWatcher
+    def initialize(root, config:, recursive: false, interval: 5, stability_window: 2)
+      @root = root
+      @config = config
+      @recursive = recursive
+      @interval = [interval.to_i, 1].max
+      @stability_window = [stability_window.to_i, 1].max
+      @seen = {}
+    end
+
+    def run(apply: false, iterations: nil)
+      cycles = 0
+      loop do
+        scan = DirectoryScanner.new(@root, config: @config, recursive: @recursive).scan
+        stable = scan[:files].select { |file| stable?(file) }
+        items = OrganizationPlanner.new(@root, @config).plan(stable)
+        yield(items, apply) if block_given?
+        cycles += 1
+        break if iterations && cycles >= iterations
+
+        sleep @interval
+      end
+    rescue Interrupt
+      nil
+    end
+
+    private
+
+    def stable?(file)
+      key = file.absolute_path
+      current = [file.size, file.modified_at.to_f]
+      previous = @seen[key]
+      @seen[key] = { signature: current, changed_at: Time.now }
+      return false unless previous && previous[:signature] == current
+
+      Time.now - previous[:changed_at] >= @stability_window
+    end
+  end
+end

data/lib/soft_sort.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'yaml'
+require 'optparse'
+require 'pathname'
+require 'fileutils'
+require 'digest'
+require 'securerandom'
+require 'time'
+require_relative 'soft_sort/version'
+require_relative 'soft_sort/errors'
+require_relative 'soft_sort/configuration'
+require_relative 'soft_sort/scanning/file_metadata'
+require_relative 'soft_sort/scanning/directory_scanner'
+require_relative 'soft_sort/classification/type_classifier'
+require_relative 'soft_sort/classification/context_classifier'
+require_relative 'soft_sort/classification/classification_result'
+require_relative 'soft_sort/classification/rule_matcher'
+require_relative 'soft_sort/classification/sensitive_file_detector'
+require_relative 'soft_sort/classification/content_classifier'
+require_relative 'soft_sort/planning/organization_planner'
+require_relative 'soft_sort/reporting/preview_formatter'
+require_relative 'soft_sort/reporting/json_reporter'
+require_relative 'soft_sort/storage/transaction_journal'
+require_relative 'soft_sort/storage/root_lock'
+require_relative 'soft_sort/execution/executor'
+require_relative 'soft_sort/execution/recovery_manager'
+require_relative 'soft_sort/execution/undo_manager'
+require_relative 'soft_sort/duplicates/duplicate_detector'
+require_relative 'soft_sort/reporting/statistics_reporter'
+require_relative 'soft_sort/watching/directory_watcher'
+require_relative 'soft_sort/classification/ai_provider'
+require_relative 'soft_sort/metadata/image_metadata'
+require_relative 'soft_sort/cli'
+module SoftSort; end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: soft-sort
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- SoftSort contributors
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-11-13 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+executables:
+- soft-sort
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/soft-sort
+- config/default_rules.yml
+- lib/soft_sort.rb
+- lib/soft_sort/classification/ai_provider.rb
+- lib/soft_sort/classification/classification_result.rb
+- lib/soft_sort/classification/content_classifier.rb
+- lib/soft_sort/classification/context_classifier.rb
+- lib/soft_sort/classification/rule_matcher.rb
+- lib/soft_sort/classification/sensitive_file_detector.rb
+- lib/soft_sort/classification/type_classifier.rb
+- lib/soft_sort/cli.rb
+- lib/soft_sort/configuration.rb
+- lib/soft_sort/duplicates/duplicate_detector.rb
+- lib/soft_sort/errors.rb
+- lib/soft_sort/execution/executor.rb
+- lib/soft_sort/execution/recovery_manager.rb
+- lib/soft_sort/execution/undo_manager.rb
+- lib/soft_sort/metadata/image_metadata.rb
+- lib/soft_sort/planning/organization_planner.rb
+- lib/soft_sort/reporting/json_reporter.rb
+- lib/soft_sort/reporting/preview_formatter.rb
+- lib/soft_sort/reporting/statistics_reporter.rb
+- lib/soft_sort/scanning/directory_scanner.rb
+- lib/soft_sort/scanning/file_metadata.rb
+- lib/soft_sort/storage/root_lock.rb
+- lib/soft_sort/storage/transaction_journal.rb
+- lib/soft_sort/version.rb
+- lib/soft_sort/watching/directory_watcher.rb
+homepage: https://github.com/soft-sort/soft-sort
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: A safe, local-first file organization planner
+test_files: []